France caisse ap terminal payments
ZTZenoti Docs Team Updated July 13, 2026 2 min readGuide
Centers operating in France use the France Caisse AP integration for POS (Point of Sale) terminal payment processing. This integration facilitates real-time payment collection between POS terminals and card readers, ensuring compliance with French regulatory requirements.
Before you begin
- Your center must be located in France.
- The POS terminal must be registered and connected. The system detects duplicate connections and maintains a keep-alive handshake.
- A card reader must be physically connected to the terminal.
How France Caisse AP works
The France Caisse AP integration connects POS terminals to the payment backend for real-time card payment processing. When a front desk staff member initiates a payment:
- The POS terminal sends the payment request with the card reader address, workstation reference, amount, and currency.
- The system sends the payment request to the connected card reader.
- The guest inserts or taps their card on the reader.
- The card reader processes the payment and returns the result.
- The POS system receives the final status and updates the invoice.
Process a payment
- At the POS, select the invoice to collect payment for.
- Click Collect Payment or the equivalent action.
- The system sends the payment request to the connected card reader.
- The guest presents their card at the card reader (insert, swipe, or tap).
- The card reader processes the transaction. This may include prompting the guest for a PIN.
- The result appears on the POS screen — either confirmed or failed.
- If successful, the invoice is updated with the payment.
Payment statuses
| Status | Meaning |
|---|---|
| Received | The payment request has been received by the system. |
| Initiated | The payment request has been sent to the card reader terminal. |
| Waiting for client response | The card reader is waiting for the guest to present their card or enter a PIN. |
| Completed | Payment processed successfully. |
| Failed | Payment failed. See error codes for details. |
Error handling
If a payment fails, the system returns an error with details about the failure. Common scenarios include:
| Error | Resolution |
|---|---|
| Terminal not connected | Verify the POS terminal registration and network connection. Restart the terminal if needed. |
| Duplicate connection | Another workstation is already connected with the same terminal ID. Disconnect the other session. |
| Card reader error | Check the physical card reader connection. Ensure the reader is powered on and properly connected. |
| Transaction declined | The guest's card was declined by the issuer. Ask the guest to try a different card. |
Error codes prefixed with "CZ" are official Caisse AP responses from the French payment system.
Was this article helpful?
Your feedback helps us improve our documentation.