Guide d'installation
Relier le terminal de paiement par carte
La caisse envoie le montant au terminal de votre banque ou de votre régie, et le résultat revient tout seul. Rien n'est saisi deux fois. Ce guide décrit le protocole Caisse-AP, le protocole caisse des terminaux français.
Mis à jour le 08/10/2026.
Avant de commencer
Le pilotage Caisse-AP est disponible dans Inklura Caisse 1.5.1 (Windows/Linux) et 1.2.1 (Android) : un navigateur seul ne peut pas joindre un terminal sur votre réseau. Le protocole doit être activé par le mainteneur sur un terminal compatible. Les échanges ont été vérifiés par simulateur, sans essai sur appareil physique. Le temps de réponse de la banque ou du terminal ne fait pas partie du temps de traitement mesuré dans la caisse. En mode autonome : vous saisissez le montant sur le terminal, puis vous touchez Carte dans la caisse.
- Vous gardez votre terminal et votre contrat : celui de votre banque, ou pour une régie celui obtenu avec le comptable public. caisse.bzh ne vend pas de terminal et ne touche pas à l'argent.
- Terminaux concernés : ceux qui proposent le protocole Caisse-AP sur IP (Ingenico, Verifone, certains PAX selon l'application de la banque). Voyez le tableau du matériel.
- Les lecteurs SumUp et le paiement sur téléphone (Tap to Pay) ne sont pas au programme pour l'instant.
1. Ce qu'il faut demander au mainteneur du terminal
Le réglage se fait sur le terminal, par la société qui l'entretient (souvent par l'intermédiaire de votre banque). Comptez quelques jours. Demandez :
- l'activation du protocole caisse Caisse-AP sur IP ;
- une adresse IP fixe sur votre réseau (ou une réservation DHCP), et le port utilisé (souvent 8888) ;
- s'il y a plusieurs caisses, le numéro de caisse de chacune (01, 02...) ;
- conseillé : une liaison bancaire de secours (4G) pour le terminal, s'il doit encaisser pendant une coupure d'Internet.
Le terminal et la caisse doivent être sur le même réseau local, sans isolement des appareils (fréquent sur un Wi-Fi invité).
2. Déclarer le terminal
- Sur la caisse qui utilisera le terminal, ouvrez Réglages, Paiements carte. Le poste doit déjà être réglé dans Périphériques.
- Ajouter le terminal carte. Saisissez l'Adresse du terminal (par exemple 192.168.1.60) et son port, le Numéro de caisse (deux chiffres, par exemple 01) et le Délai d'attente (secondes) laissé au client pour présenter sa carte.
- Enregistrer le terminal, puis Vérifier la connexion : la caisse ouvre la liaison sans envoyer de montant. À la première utilisation, l'application vous demande d'approuver cette adresse sur le poste.
- Rechargez la caisse.
Il n'existe pas de débit d'essai : la première vraie vente par carte se fait pendant votre recette, avec un petit montant que vous remboursez ensuite.
3. Encaisser par carte
- À l'encaissement, touchez Carte : le montant part au terminal et la caisse affiche « Présentez la carte sur le terminal. ».
- Le client paie. Le résultat revient tout seul : « Paiement accepté » et la vente se termine, ou « Paiement refusé par le terminal » et le ticket reste ouvert.
- Pour annuler, utilisez la touche rouge du terminal : la caisse ne peut pas l'annuler à sa place.
- Le reçu de caisse porte une ligne carte (type de carte, quatre derniers chiffres, numéro d'autorisation). Le ticket carte du client est imprimé par le terminal, selon ses propres réglages.
En mode formation, le terminal n'est jamais appelé : une fenêtre « SIMULATION, aucun débit » propose « Simuler accepté » ou « Simuler refusé ».
Si le résultat est inconnu
Si la liaison est coupée pendant l'échange, la caisse ne sait pas si la carte a été débitée. Elle ne relance jamais un second débit. Elle affiche « Résultat inconnu. Regardez le ticket du terminal. » :
- regardez le ticket ou l'écran du terminal ;
- un gérant ou un manager choisit « Le terminal a accepté » ou « Le terminal a refusé ». La décision est inscrite au journal avec son auteur ;
- sans gérant ni manager présent, le paiement reste à vérifier dans Paiements carte.
Si un paiement a déjà été accepté pour ce ticket, la caisse le propose avec Reprendre ce paiement, au lieu de débiter la carte une seconde fois.
Les paiements à vérifier
Dans Paiements carte, un gérant ou un manager règle les cas restés ouverts :
- Paiement carte sans vente : le terminal a accepté, mais aucune vente ne porte ce paiement. Saisissez le N° du ticket de caisse puis Rattacher à cette vente, ou classez-le « Remboursé au client ».
- Résultat inconnu : tranchez d'après le ticket du terminal.
- Aucune action : possible seulement avec une note.
En fin de journée
Journée par carte donne les paiements acceptés par poste et par terminal. Comparez-les au ticket de télécollecte de chaque terminal, puis au relevé du compte. caisse.bzh ne voit pas votre banque : ce rapprochement reste une vérification humaine.
Quand Internet ou le serveur ne répond plus
La liaison entre la caisse et le terminal passe par votre réseau local, pas par Internet. Mais le terminal a besoin de sa propre liaison bancaire pour autoriser un paiement. Et si le serveur caisse.bzh est injoignable, la caisse refuse de lancer un paiement qu'elle ne pourrait pas enregistrer : « Serveur injoignable : utilisez le terminal en mode autonome, puis le bouton Carte. »
Ce que nous n'avons pas encore vérifié
Le protocole Caisse-AP a été écrit d'après des sources publiques et essayé contre notre terminal simulé : paiement accepté, refusé, coupure, réponse pour un autre montant. Il reste à l'essayer sur un vrai terminal avec un vrai contrat, et à le comparer à la spécification officielle de l'Association du Paiement. Nous ferons ce premier essai avec vous si votre terminal est le premier de son modèle.