Documentation développeur Caisses Caisse v2 Fonctionnel Paiements
November 26, 2025 at 2:48 AMMéthodes de paiement
Vue d’ensemble
La caisse v2 supporte plusieurs méthodes de paiement. Un panier peut être payé avec une ou plusieurs méthodes (paiement mixte).
Paiement en espèce
Fonctionnement
- Clic sur “Paiement espèce”
- Ouverture automatique du tiroir caisse : Le tiroir s’ouvre pour permettre au caissier de prendre l’argent
- Saisie du montant donné : Le caissier saisit le montant donné par le client
- Calcul automatique :
- Le système calcule la monnaie à rendre
- Si les arrondis sont activés (XPF), le montant à payer est ajusté automatiquement
- Validation : Le paiement est ajouté au panier
Arrondis automatiques (XPF uniquement)
Pour les paiements en espèce en XPF (Franc Pacifique) avec une précision décimale de 0 (montants entiers uniquement), le système applique des arrondis automatiques selon le dernier chiffre du montant à payer.
Principe d’arrondi :
Le montant à payer est ajusté selon le dernier chiffre selon la table suivante :
| Dernier chiffre | Ajustement appliqué | Exemple |
|---|---|---|
| 0 | 0 | 1230 XPF → 1230 XPF |
| 1 | -1 | 1231 XPF → 1230 XPF |
| 2 | -2 | 1232 XPF → 1230 XPF |
| 3 | +2 | 1233 XPF → 1235 XPF |
| 4 | +1 | 1234 XPF → 1235 XPF |
| 5 | 0 | 1235 XPF → 1235 XPF |
| 6 | -1 | 1236 XPF → 1235 XPF |
| 7 | -2 | 1237 XPF → 1235 XPF |
| 8 | +2 | 1238 XPF → 1240 XPF |
| 9 | +1 | 1239 XPF → 1240 XPF |
Exemples concrets :
- Montant à payer : 1231 XPF → Arrondi à 1230 XPF (dernier chiffre 1, ajustement -1)
- Montant à payer : 1233 XPF → Arrondi à 1235 XPF (dernier chiffre 3, ajustement +2)
- Montant à payer : 1235 XPF → Reste 1235 XPF (dernier chiffre 5, pas d’ajustement)
Affichage :
- Le montant arrondi est utilisé pour le calcul de la monnaie à rendre
- L’ajustement d’arrondi (différence entre le montant original et le montant arrondi) est affiché entre parenthèses dans le panier
- Le montant réellement donné par le client reste inchangé
Affichage dans le panier
Le paiement en espèce affiche :
- Le montant payé (montant arrondi si applicable)
- L’ajustement d’arrondi entre parenthèses (si applicable)
- Le montant donné par le client
- La monnaie à rendre
Paiement par carte (TPE)
Fonctionnement
- Clic sur “Paiement carte”
- Initiation de la transaction : Le terminal de paiement est activé
- Insertion de la carte : Le client insère sa carte dans le terminal
- Saisie du code PIN : Le client saisit son code PIN (si requis)
- Validation :
- Si la transaction réussit, le paiement est ajouté au panier
- Si la transaction échoue, un message d’erreur s’affiche
- Forçage : En cas d’erreur matérielle, le caissier peut forcer le paiement (avec autorisation)
Types de cartes supportés
- Carte bancaire classique : Insertion de la carte
- Sans contact (contactless) : Approche de la carte
- AMEX : Cartes American Express
- JADE : Cartes JADE (si configuré)
Drive-in
Pour les cinémas drive-in, des méthodes spécifiques sont utilisées :
card_drive_inau lieu decardemv_contactless_drive_inau lieu deemv_contactless
Paiement par chèque
Fonctionnement
- Clic sur “Paiement chèque”
- Saisie du montant : Le caissier saisit le montant du chèque
- Saisie du numéro de chèque (CMC7) : Lecture ou saisie manuelle du numéro
- Sélection de la banque : Choix de la banque émettrice
- Validation : Le paiement est ajouté au panier
Vérifications
- Le montant ne peut pas dépasser le reste à payer
- Le numéro de chèque doit être valide
Paiement par prépayé
Fonctionnement
- Clic sur “Paiement prépayé”
- Recherche des prépayés : Le système recherche les prépayés disponibles pour le client
- Sélection automatique : Le système sélectionne automatiquement les prépayés optimaux
- Application :
- Les prépayés sont appliqués aux lignes de séances
- Des entrées de paiement sont créées pour chaque prépayé utilisé
- Validation : Les réductions sont appliquées au panier
Optimisation
Le système calcule automatiquement la meilleure utilisation des prépayés :
- Maximise les réductions
- Applique les prépayés aux séances les plus chères en priorité
Affichage dans le panier
- Les réductions appliquées sont visibles sur les lignes de séances
- Les prépayés utilisés apparaissent dans les paiements
Paiement par voucher
Fonctionnement
- Clic sur “Paiement voucher”
- Recherche de vouchers : Le système recherche les vouchers disponibles
- Sélection : Le caissier sélectionne les vouchers à utiliser
- Application :
- Chaque voucher est ajouté comme une entrée de paiement
- Le montant du voucher est déduit du reste à payer
- Validation : Les vouchers sont appliqués au panier
Vérifications
- Les vouchers doivent être valides et non expirés
- Un voucher ne peut être utilisé qu’une seule fois par panier
- Le montant total des vouchers ne peut pas dépasser le reste à payer
Paiement par carte d’abonnement
Fonctionnement
- Clic sur “Paiement carte” (carte abonnement)
- Recherche de la carte : Le système recherche la carte du client
- Vérification :
- Validité de la carte
- Nombre de places disponibles
- Type de carte et réductions applicables
- Application des réductions :
- Les réductions sont appliquées aux séances selon le type de carte
- Le nombre de places utilisées est incrémenté
- Validation : Les réductions sont appliquées au panier
Types de cartes
- Carte illimitée : Accès illimité aux séances
- Carte avec quota : Nombre limité de places par période
- Carte avec réductions : Réductions sur les prix selon le type
Paiement mixte
Fonctionnement
Un panier peut être payé avec plusieurs méthodes :
- Le client peut payer une partie en espèce et le reste par carte
- Le client peut utiliser plusieurs vouchers
- Le client peut combiner plusieurs méthodes
Affichage
- Chaque paiement apparaît séparément dans le panier
- Le reste à payer est mis à jour après chaque paiement
- Le total payé est la somme de tous les paiements
Validation
Le panier ne peut être finalisé que si :
- Le total payé est supérieur ou égal au total TTC
- Tous les paiements sont validés
Monnaie à rendre
Calcul
La monnaie à rendre est calculée automatiquement :
- Pour les paiements en espèce :
montant donné - montant à payer - Pour les autres méthodes : 0 (pas de monnaie)
Affichage
- La monnaie à rendre s’affiche dans le panier
- Elle est mise à jour automatiquement lors des modifications
Erreurs de paiement
Erreurs courantes
- Montant insuffisant : Le montant donné est inférieur au montant à payer
- Erreur TPE : Problème de communication avec le terminal
- Voucher invalide : Le voucher n’est pas valide ou a déjà été utilisé
- Carte invalide : La carte d’abonnement n’est pas valide ou n’a plus de places
Gestion des erreurs
- Un message d’erreur s’affiche
- Le paiement n’est pas ajouté au panier
- Le caissier peut réessayer ou choisir une autre méthode