ZenotiHelp

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:

  1. The POS terminal sends the payment request with the card reader address, workstation reference, amount, and currency.
  2. The system sends the payment request to the connected card reader.
  3. The guest inserts or taps their card on the reader.
  4. The card reader processes the payment and returns the result.
  5. The POS system receives the final status and updates the invoice.

Process a payment

  1. At the POS, select the invoice to collect payment for.
  2. Click Collect Payment or the equivalent action.
  3. The system sends the payment request to the connected card reader.
  4. The guest presents their card at the card reader (insert, swipe, or tap).
  5. The card reader processes the transaction. This may include prompting the guest for a PIN.
  6. The result appears on the POS screen — either confirmed or failed.
  7. 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.