Paiements par QR code

Un QR code CashChap est l'adresse d'une page de paiement sur https://payment.cashchap.com. Le client le scanne avec l'appareil photo de son téléphone, voit votre nom et celui de votre service, puis paie par Mobile Money, sans application à installer. Trois QR codes sont proposés : celui de chaque CashChap Link, le QR fixe de votre boutique pour le comptoir, et le QR à usage unique affiché par Ma boutique.

Trois QR codes

Chaque QR code appartient au service et au mode (Live ou Sandbox) affichés dans le portail. Un QR code Sandbox ouvre une page en mode test (https://payment.cashchap.com/sandbox/…) et ne débite jamais d'argent réel ; un QR code Live ouvre https://payment.cashchap.com/live/…. Les deux ne se mélangent jamais : basculez le portail sur Sandbox pour obtenir les QR codes de test.

Les trois pages s'affichent dans la devise de votre service : prix, montant saisi par le client, frais, total, reçu et facture. Le client ne voit jamais le XOF prélevé par l'opérateur. À la fin du paiement, le client voit l'écran « Paiement effectué » avec son reçu, à télécharger ou à partager, la facture et le QR code d'authentification du reçu (voir Reçus et vérification).

QR code d'un CashChap Link

Chaque lien de paiement a son QR code. Dans Paiements › CashChap Link, le bouton QR de la ligne (ou QR code dans le menu …) ouvre la fenêtre « QR code du lien » ; le même bloc figure dans le Détail du lien. Le scan ouvre la page produit du lien, la même que l'adresse https://payment.cashchap.com/live/… partagée par message (voir La page de paiement).

• Image PNG et Image SVG (vectorielle, nette à toutes les tailles, pour votre imprimeur) : à poser sur un site, un catalogue, une publication.
• Affiche A4 et Affiche A6 : page prête à imprimer avec le logo CashChap, le nom de votre entreprise et du service, le produit, le prix ou « Montant libre », « Scannez pour payer », le QR code, l'adresse en clair et les logos MTN et Moov. PDF A4 et PDF A6 donnent le même document en fichier.
• Un lien désactivé ou supprimé ne permet plus de payer, par son adresse comme par son QR code : retirez les affiches correspondantes.

QR code de la boutique

Pour le comptoir, la vitrine ou un stand : un QR code permanent, à imprimer une fois. Le client le scanne, voit votre nom et celui du service, saisit le montant que vous lui indiquez (dans la devise du service) et paie. Ouvrez Paiements › QR code de la boutique : le QR code du service et du mode affichés est créé automatiquement à votre première visite. Il est propre à chaque service et à chaque mode : le QR code de la boutique en Sandbox est différent de celui en Live.

• Télécharger le QR code : Image PNG ou Image SVG (vectorielle).
• Affiche à imprimer : Affiche A4 ou Affichette A6 (comptoir), à imprimer depuis le navigateur, ou PDF A4 et PDF A6. L'affiche porte le logo CashChap, le nom de votre entreprise et du service, « Montant libre », « Scannez pour payer », le QR code, son adresse en clair, une phrase d'explication pour le client et les logos MTN et Moov ; en Sandbox, un bandeau « MODE TEST » la distingue.
• Ce QR code n'apparaît pas dans la liste des CashChap Link : il ne peut pas y être modifié ni supprimé par erreur.
• Les paiements reçus par ce QR code figurent dans Paiements client, comme ceux d'un lien de paiement, et déclenchent les mêmes notifications et webhooks.
• La page est ouverte aux mêmes collaborateurs que Ma boutique.

Régénérer le QR code de la boutique

Si une affiche a été détournée (un autre QR code collé par-dessus, par exemple) ou si vous voulez simplement changer de QR code, cliquez sur Régénérer le QR code et confirmez avec le mot de passe de votre compte (celui du collaborateur pour une session invitée ; cinq essais manqués par quart d'heure bloquent temporairement la confirmation). Seuls le titulaire du compte et les administrateurs peuvent le faire.

• Un nouveau QR code est créé pour le service et le mode affichés ; l'ancien est désactivé immédiatement : un client qui le scanne voit « QR code annulé » (« Ce QR code a été annulé ou remplacé : demandez un nouveau QR code au marchand. »). Remplacez toutes les affiches imprimées.
• La régénération, réussie ou refusée, est inscrite dans Compte › Journal d'activité (« QR CODE BOUTIQUE »).
• Les paiements déjà reçus par l'ancien QR code sont conservés.

QR code à la caisse

À la caisse, le client paie lui-même le montant exact, sans dicter son numéro : dans Paiements › Ma boutique, saisissez le montant (le numéro du client n'est pas nécessaire), puis cliquez sur Afficher un QR. La caisse saisit et affiche les montants dans la devise de votre service (le libellé du champ le rappelle : « Montant (EUR) ») : un service en euros encaisse 12,50 EUR, le client voit 12,84 EUR frais compris, et les euros le suivent jusqu'au reçu ; l'opérateur, lui, prélève l'équivalent en XOF.

1. Le QR code s'affiche à l'écran, avec le montant, le total payé par le client (frais et arrondi au 5 F compris, calculé comme pour un encaissement de Ma boutique) et le délai restant (« Valable encore 4 min 26 s »). Tournez l'écran vers le client.
2. Le client scanne : la page « Paiement en caisse » s'ouvre sur son téléphone, avec votre nom, le service, la caisse, le montant et le même compte à rebours. Il appuie sur Procéder au paiement, choisit son opérateur, saisit son numéro et valide sur son téléphone. Il paie exactement le total annoncé par la caisse : il ne peut pas modifier le montant.
3. La caisse suit le paiement en direct (« En attente du paiement du client… ») et affiche Paiement reçu avec le total payé ; Voir le reçu ouvre le reçu imprimable de la caisse, Nouvelle vente prépare l'encaissement suivant. Le client, lui, voit l'écran final avec son reçu.

• Usage unique : un QR code payé ne paie plus rien ; un nouveau scan affiche « QR code déjà payé ». Pendant qu'un client paie, un second payeur reçoit « Un paiement est déjà en cours avec ce QR code. Patientez quelques instants. ».
• Durée limitée : 5 minutes. Passé ce délai, la caisse affiche « QR expiré » et propose Nouveau QR ; le client qui scanne voit « QR code expiré ». Un paiement lancé avant l'expiration va à son terme.
• Annuler le QR : tant que le client n'a pas lancé son paiement, le caissier peut annuler le QR code ; il ne permet plus de payer (« QR code annulé »). Une fois le paiement lancé, l'annulation est refusée.
• Ces règles sont contrôlées par les serveurs de CashChap, pas seulement à l'écran : un QR code expiré, annulé ou déjà payé est refusé même si la page est restée ouverte ou si l'adresse est rejouée.
• Attribution à la caisse : la vente apparaît dans Paiements marchand, comme un encaissement de Ma boutique, avec le collaborateur qui a affiché le QR code et sa caisse (canal shop, terminal « Boutique du portail ») ; elle suit les tarifs de la boutique et donne lieu aux mêmes notifications et webhooks.

Voir le reçu ouvre le reçu imprimable de la caisse (largeur d'un ticket de 58 mm) : logo et coordonnées du marchand, « PAIEMENT RÉUSSI » (et « MODE TEST » en Sandbox), montant, frais, total payé, moyen, numéro complet du client, son nom, canal « Caisse (QR code) » avec le nom de la caisse, date, n° de reçu, références, puis l'adresse de vérification et son QR code. Imprimer l'envoie à l'imprimante ; le client peut aussi scanner le QR code pour vérifier le paiement sur cashchap.com (voir la page de vérification).

La caisse d'un service en euros

Mêmes écrans, dans la devise du service : le caissier saisit 12,50, le QR code annonce 12,50 EUR et un total de 12,84 EUR frais compris (dont 0,13 EUR de frais de change, le prix étant en euros et prélevé en XOF), la page du client et le reçu imprimable sont en euros.

Ce que voit le client

Quand un QR code de caisse ou de boutique ne permet plus de payer, la page l'explique au client en français, sans formulaire de paiement (pour un CashChap Link désactivé : « Lien de paiement indisponible ») :

QR de caisse dans l'API v2

Ma boutique crée ses QR codes avec l'API publique v2, comme le ferait un terminal de paiement : vos caisses et vos TPE peuvent faire de même avec POST /v2/checkouts (jeton de session de caisse, clé de terminal ou clé secrète ; montant dans la devise du service par défaut depuis l'API 2.2.0, précisez toujours currency), puis suivre l'état avec GET /v2/checkouts/{id}?wait=5. Le QR code à afficher est l'adresse url de la réponse. Détail des routes, de l'objet checkout et des refus dans API v2 › QR codes de caisse.

La page de paiement d'un QR code s'appuie sur les routes publiques des liens (GET /v2/payment-links/{id}…) : le champ kind y indique un CashChap Link (link), le QR code de la boutique (shop) ou un QR de caisse (checkout). Voir API publique des liens.

Bonnes pratiques

• Imprimez l'affiche du QR code de la boutique en couleur et posez-la à hauteur des yeux, près de la caisse ; vérifiez de temps en temps qu'aucun autocollant n'a été collé par-dessus, et régénérez le QR code au moindre doute.
• Dites au client le montant à saisir avec le QR code de la boutique ; pour un montant exact, préférez Afficher un QR dans Ma boutique.
• Le paiement fait foi quand il apparaît dans le portail (ou par webhook) : ne vous fiez pas à une capture d'écran présentée par le client.
• Pour former votre équipe, basculez le portail en Sandbox : les QR codes de test se paient avec les numéros de test (01 66 00 00 00 pour un paiement réussi).