ZenotiHelp

Processor: Caisseap

ZTZenoti Docs Team Updated September 5, 2026 3 min readGuide

CaisseAP is a V1 payment processor configured at the center level. It is a terminal-only, offline-mode processor designed for the French market β€” all transactions are captured on a physical card reader and settled in batch by the terminal itself. There is no online channel, no stored accounts, and no online refund path.

Before you begin

Permission: Center-level payment configuration access is required.

CaisseAP merchant-side prerequisites

  • CaisseAP merchant agreement activated in France with a compatible physical terminal.
  • Terminal delivery and bank-TMS personalisation β€” the French acquiring bank loads the terminal with merchant and acquirer keys. The terminal is useless until this step is complete.
  • Center locale and currency β€” must be set to France and EUR in Zenoti before enabling CaisseAP.

Credentials

Field Source / owner What to enter
CaisseAP credentials CaisseAP account representative Issued on MID (Merchant Identifier) activation. [SOURCE GAP β€” PM VERIFY: exact field names; CaisseAPProcessor.cs uses a standard CCProcessorElement parameter set but does not expose field names in the article-layer FS.]

Network requirements

The CaisseAP terminal operates in offline / batched mode β€” transactions are captured locally on the terminal and batched to the acquirer on an end-of-day cycle. Internet at the terminal is required only during batch upload.

Direction Port Protocol Why
Outbound from CaisseAP terminal to acquirer Acquirer-defined TLS End-of-day batch upload. Handled by the terminal; not a Zenoti network path.
Outbound from Zenoti to CaisseAP integration endpoint (when online) 443 HTTPS Transaction initiation and status checks when the terminal is reachable.

CaisseAP capabilities in Zenoti

Capability Supported
Sale (terminal) Yes
Offline card capture Yes
Card reader (terminal) Yes (dedicated card-reader pattern referenced in)
Stored accounts No
Tokenization No
Recurring payments No
Webstore / online (HPP (Hosted Payment Page)) No
Refund [SOURCE GAP β€” PM VERIFY: CaisseAPProcessor.cs has no RefundTransaction. Refunds in the French offline model are usually performed at the terminal, not through the processor API.]
Void [SOURCE GAP β€” PM VERIFY: same as refund.]

Configure CaisseAP

  1. At the center level, navigate to Configuration > Payments > Settings (the center-scope caption of the Payments row).
  2. Select CaisseAP as the payment processor.
  3. Enter your CaisseAP credentials.
  4. Assign the physical card reader(s) to this center.
  5. Select Save.
  6. Select Test to verify the credentials.

Process a payment

  1. Front-desk staff selects CaisseAP on the invoice.
  2. Zenoti sends the amount to the CaisseAP terminal.
  3. The guest completes the payment on the terminal (chip, contactless, or swipe).
  4. The terminal returns approval / decline to Zenoti and stores the transaction locally until end-of-day batching.

Edit or reverse a posted payment

Invoice state What you can do
Open Remove the CaisseAP payment line while the transaction is still pending at the terminal. After terminal approval, reverse on the terminal itself and record the reversal reference in Zenoti.
Closed Zenoti cannot reverse a CaisseAP charge after the invoice is closed. Process the refund / reversal on the physical terminal per your acquirer's procedure, then post a compensating entry in Zenoti.

Failure modes

Failure mode User-visible symptom Resolution
Terminal unreachable Zenoti shows "terminal not responding." Check terminal power and network; retry.
Auth / TMS expired on terminal Terminal rejects the transaction with an acquirer error. Contact the French acquirer to refresh the terminal's TMS personalisation.
Card declined Terminal shows issuer decline. Guest retries.
Amount out of range Terminal rejects small or large amounts per acquirer limits. Use a different payment method.
Currency mismatch Terminal rejects non-EUR. Confirm center currency is EUR.
Batch upload failure End-of-day batch fails; transactions accumulate on the terminal. Restore internet and re-run the batch from the terminal menu. Acquirer will age out old batches per their policy.

Settlement and reconciliation

CaisseAP settlement is acquirer-driven and tied to the terminal's end-of-day batch cycle. French bank holidays and weekends delay settlement. [SOURCE GAP β€” PM VERIFY: typical T+N window for French CB / Visa / Mastercard via CaisseAP.]

Source Report / view Match key
Zenoti Collections report (filter: Payment Method = CaisseAP) Terminal transaction reference + Zenoti invoice number
CaisseAP / acquirer Terminal end-of-day report + acquirer bank statement Same fields

Recommended cadence: daily end-of-day, matched to the terminal batch cycle.

Tips

  • CaisseAP is designed for the French market. Ensure the center's locale and currency settings are configured for France (EUR) before enabling CaisseAP.
  • Offline card transaction support allows payments to be captured and processed even if internet connectivity is temporarily unavailable. Batches still require connectivity to upload at end of day.
  • Refunds and reversals are typically performed on the physical terminal per the acquirer's procedure β€” not through Zenoti.
Was this article helpful?
Your feedback helps us improve our documentation.