Processor: Caisseap
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
- At the center level, navigate to Configuration > Payments > Settings (the center-scope caption of the Payments row).
- Select CaisseAP as the payment processor.
- Enter your CaisseAP credentials.
- Assign the physical card reader(s) to this center.
- Select Save.
- Select Test to verify the credentials.
Process a payment
- Front-desk staff selects CaisseAP on the invoice.
- Zenoti sends the amount to the CaisseAP terminal.
- The guest completes the payment on the terminal (chip, contactless, or swipe).
- 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.