Paiement par QR code au Maroc : l'affiche de comptoir qui encaisse la carte

Le paiement par QR code au Maroc, avec ChariPay, c'est un lien de paiement imprimé : vous générez le QR code ou l'affiche PDF à imprimer d'un lien réutilisable, vous la posez au comptoir, et vos clients scannent avec leur téléphone pour payer par carte avec 3-D Secure, sur une page hébergée par ChariPay qui affiche votre nom. Aucun terminal à installer. Ce guide explique d'où vient le QR, quel lien mettre derrière, où le placer, ce que voit le client, comment suivre ce qu'une affiche encaisse, et les erreurs qui transforment une affiche en source de malentendus.

Le paiement par QR code au Maroc, tel que ChariPay le propose

Chez ChariPay, un QR code de paiement est l'image d'un lien de paiement. Un lien de paiement, c'est un montant et une description ; le client paie sur une page hébergée par ChariPay. Il se partage par lien, QR code, affiche PDF à imprimer, e-mail ou WhatsApp. Le QR code encode simplement l'adresse de la page de paiement du lien : le client qui le scanne arrive sur cette page, comme s'il avait cliqué sur le lien reçu par message.

ChariPay est une plateforme de paiement marocaine, un PSP opéré par Chari Money, établissement de paiement agréé par Bank Al-Maghrib. Sur la page, le client paie par carte. Par défaut : Visa, Mastercard et Maroc Pay. D'autres moyens peuvent être activés sur demande auprès de l'équipe, selon votre activité. Les paiements par carte passent par l'authentification 3-D Secure : le porteur confirme auprès de sa banque, ce qui protège le commerçant contre l'essentiel des impayés et des contestations.

Le QR est donc un canal de partage parmi d'autres, pensé pour le monde physique : un comptoir, un stand, une vitrine, un document imprimé. Si vous cherchez la vue d'ensemble — encaisser la carte à distance, au comptoir et sur un site sans aucun terminal —, lisez notre guide pour accepter la carte sans terminal ; l'offre complète est sur la page des liens de paiement. Ici, nous zoomons sur le QR et l'affiche.

D'où vient le QR : portail, image PNG, affiche PDF à imprimer

Tout QR code de paiement part d'un lien existant. Créez d'abord le lien — montant, description, expiration, et usage unique ou, par l'API, réutilisable —, en suivant si besoin notre guide pour créer un lien de paiement. Ensuite, deux formats sont disponibles :

• Le QR code seul, en image PNG : à insérer dans un document, un menu, un bon de livraison, un support que vous concevez vous-même.
• L'affiche PDF à imprimer, pour le comptoir : elle porte le QR code et le montant.

Dans le portail, le QR code de chaque lien s'affiche en un clic depuis la liste des liens de paiement, et l'affiche s'obtient depuis la fiche du lien. Par l'API, deux appels renvoient le QR et l'affiche, à partir de la reference du lien (pl_…) :

# PNG QR code that encodes the link's payUrl
curl -X GET 'https://api-psp.charipay.ma/v1/payment-links/pl_3ND8xk/qr' \
  -H 'X-CHARI-PAY-API-KEY: chari_sk_test_...' \
  -o pl_3ND8xk-qr.png

# Printable poster (PDF) with the QR code and the amount
curl -X GET 'https://api-psp.charipay.ma/v1/payment-links/pl_3ND8xk/poster' \
  -H 'X-CHARI-PAY-API-KEY: chari_sk_test_...' \
  -o pl_3ND8xk-poster.pdf

GET /v1/payment-links/{reference}/qr renvoie le PNG, GET /v1/payment-links/{reference}/poster le PDF de l'affiche. Un réseau de points de vente peut ainsi produire ses affiches en série depuis son propre outil. Les paramètres et les réponses d'erreur sont décrits dans le module « Liens de paiement » de la documentation.

Une affiche se teste en la scannant vous-même avant de la poser. Le mode test s'ouvre dès l'activation de votre compte, sans validation à attendre : Commencer en mode test — trois champs (nom, e-mail professionnel, entreprise), un lien d'activation reçu par e-mail pour choisir votre mot de passe, puis le portail, où vous créez vous-même votre clé de test après une ré-authentification ; la clé complète ne s'affiche qu'une seule fois. Créez un lien, affichez son QR depuis la liste des liens, scannez-le avec votre téléphone et payez avec la carte de test 4918 9141 0719 5005, CVV 123, n'importe quelle date d'expiration future, code 3-D Secure 555 : seule cette carte est acceptée, et aucun argent réel ne circule. La vérification de votre entreprise (KYB) se fait en parallèle et ne conditionne que le passage en production.

QR réutilisable ou à usage unique : quel lien derrière l'image

Le QR ne change rien aux règles du lien qu'il encode. Tout se joue donc au moment de créer ce lien.

La règle à retenir : une affiche ou un QR de comptoir permanent, c'est un lien réutilisable, et un lien réutilisable encaisse par carte. Ce lien réutilisable se crée par l'API, avec singleUse: false ; une fois créé, il apparaît dans le portail comme les autres. Sans développeur, au comptoir : créez un lien à usage unique au montant de la vente et affichez son QR code depuis la liste des liens. Une affiche imprimée à partir d'un lien à usage unique ne sert qu'au premier payeur ; le client suivant tomberait sur un lien déjà payé.

Où placer le QR code de paiement

Un QR code de paiement se place là où le client a déjà décidé d'acheter, et là où il peut sortir son téléphone sans gêner la file.

• Au comptoir ou à la caisse : l'emplacement le plus naturel, face au client, à hauteur des yeux. Au comptoir d'un restaurant ou d'un snack, le flux complet — commandes à distance, comptoir, équipe — est décrit dans notre guide du paiement en ligne pour restaurant.
• Sur un stand de salon, de marché ou d'événement : une affiche par produit ou par tarif. Pour les inscriptions et les billets d'un événement, voyez notre guide de la billetterie en ligne.
• En vitrine, pour un produit ou une prestation à prix fixe que l'on peut régler en passant.
• Sur un bon de livraison ou un document destiné à un seul client : c'est alors le QR d'un lien à usage unique, celui de cette commande, inséré en image PNG. Le client qui le scanne arrive sur la page de ce lien, qui lui propose la carte ou les espèces en agence.

Deux règles valent partout. Écrivez en clair, à côté du code, le montant et l'objet — « Coffret découverte — 199 MAD » — pour que le client sache ce qu'il paie avant de scanner. Et prévoyez une affiche par montant ou par produit : un même QR pour deux prix différents est impossible, puisque le montant est celui du lien.

Ce que voit votre client quand il scanne

Le parcours côté client tient en cinq étapes, sans application à installer :

1. 1Il scanne le QR avec son téléphone.
2. 2La page de paiement s'ouvre : elle affiche votre nom et votre logo, réglés depuis les paramètres de votre compte, avec le montant et la description du lien.
3. 3Il saisit sa carte. Par défaut : Visa, Mastercard et Maroc Pay.
4. 4Il confirme auprès de sa banque : c'est l'authentification 3-D Secure, qui protège le commerçant contre l'essentiel des impayés et des contestations.
5. 5Le paiement est validé ; de votre côté, vous êtes notifié dans le portail.

Au comptoir, regardez la notification plutôt que l'écran du téléphone que le client vous tend : c'est la preuve qui compte. Les rôles du portail s'y prêtent : le caissier encaisse sans voir le solde ni les virements, le comptable lit tout sans rien déclencher.

Suivre les paiements reçus sur une affiche

Une affiche réutilisable encaisse toute la journée ; il faut pouvoir dire, à tout moment, ce qu'elle a rapporté.

• Dans le portail, vous êtes notifié à chaque encaissement, et le lien garde son statut et son origine dans la liste.
• Par l'API, GET /v1/payment-links/{reference} renvoie notamment useCount, le nombre de fois où le lien a été payé, et totalCollected, le total encaissé par ce lien.
• Dans l'entonnoir du lien, le portail montre combien ont ouvert la page, combien ont saisi leur carte, combien sont allés au bout.

L'entonnoir est précieux pour une affiche : des ouvertures sans saisie de carte peuvent signaler un montant ou un objet mal compris à la lecture de l'affiche ; des saisies sans paiement abouti renvoient plutôt à la carte du client ou à l'authentification. Chaque paiement est disponible sur votre compte de paiement dès qu'il réussit, et il figure dans vos exports avec sa référence.

Renouveler ou annuler une affiche

Une affiche vit aussi longtemps que le lien qu'elle porte. Choisissez son expiration en conséquence : jamais pour une affiche permanente au comptoir, une date précise pour une offre de saison, un salon ou un menu du mois. Passé ce délai, la page indique au client que l'offre n'est plus disponible, et aucun paiement ne peut plus passer.

Pour changer de prix, ne réimprimez pas la même affiche avec un autocollant : annulez le lien — un lien annulé ne peut plus être payé —, créez un nouveau lien au nouveau montant, et imprimez son affiche. Puis retirez physiquement les anciennes affiches, partout où elles étaient posées : un QR annulé laissé au mur fait perdre une vente et oblige votre équipe à s'expliquer.

Tenez une liste simple de vos affiches en circulation — emplacement, montant, référence du lien — : le jour d'un changement de prix, vous savez quelles affiches retirer.

Les erreurs à éviter avec un QR code de paiement

• L'affiche à un prix périmé : le client paie l'ancien montant, et vous devez réclamer ou rembourser la différence.
• L'affiche d'un lien annulé ou expiré laissée au mur : le client scanne et ne peut pas payer.
• Un QR sans montant ni objet écrits à côté : le client hésite à scanner un code dont il ignore ce qu'il déclenche.
• Un lien à usage unique imprimé sur une affiche : seul le premier client peut payer.
• La mention « espèces acceptées » sur l'affiche : c'est faux, l'affiche encaisse par carte. Pour un client qui veut payer en espèces, envoyez-lui un lien à usage unique ; le fonctionnement est détaillé dans notre guide pour encaisser en espèces en agence.
• Se fier à l'écran du client plutôt qu'à la notification : seul le paiement notifié dans votre portail compte.

Questions fréquentes

Comment créer un QR code de paiement ?

Créez d'abord un lien de paiement — par l'API, avec singleUse: false, pour l'affiche permanente d'un comptoir —, puis affichez son QR code depuis la liste des liens du portail. Par l'API, GET /v1/payment-links/{reference}/qr renvoie le PNG et GET /v1/payment-links/{reference}/poster l'affiche PDF à imprimer, avec le QR et le montant. Le QR encode l'adresse de la page de paiement du lien.

Un client peut-il payer en espèces en scannant l'affiche ?

Non. Une affiche ou un QR de comptoir permanent correspond à un lien réutilisable, et un lien réutilisable encaisse par carte uniquement. Les espèces en agence passent toujours par un lien à usage unique, avec une référence par dépôt. Pour un client qui veut payer en espèces, créez un lien à usage unique à son montant et envoyez-le-lui par message.

Peut-on utiliser le même QR code pour plusieurs clients ?

Oui, si le lien derrière le QR est réutilisable : chaque client scanne et paie le même montant, jusqu'à l'expiration ou l'annulation du lien. C'est le cas d'une affiche de comptoir ou de stand. Un lien à usage unique, au contraire, est consommé après un paiement réussi : imprimé sur une affiche, il ne servirait qu'au premier client.

Quelles cartes fonctionnent avec un QR code de paiement ?

Par défaut : Visa, Mastercard et Maroc Pay. D'autres moyens peuvent être activés sur demande auprès de l'équipe, selon votre activité. Le QR ouvre la même page de paiement qu'un lien envoyé par message : le client saisit sa carte, puis confirme le paiement auprès de sa banque grâce à l'authentification 3-D Secure.

Comment changer le prix d'une affiche de paiement déjà imprimée ?

Le montant est celui du lien : il faut donc un nouveau lien. Annulez l'ancien, qui ne pourra plus être payé, créez un lien au nouveau montant, imprimez son affiche, puis retirez toutes les anciennes affiches. Tenir une liste de vos affiches en circulation, avec leur emplacement et la référence du lien, rend ce remplacement rapide et sans oubli.

Comment savoir combien une affiche a encaissé ?

Dans le portail, chaque encaissement vous est notifié. Par l'API, GET /v1/payment-links/{reference} renvoie useCount, le nombre de paiements, et totalCollected, le total encaissé par ce lien. L'entonnoir du lien montre aussi combien de personnes ont ouvert la page, saisi leur carte et payé, ce qui aide à repérer une affiche mal comprise.

Un QR code de paiement expire-t-il ?

Il expire quand le lien qu'il encode expire. À la création du lien, vous choisissez : 24 heures, 7 jours, 30 jours, jamais, ou une date précise. Pour une affiche permanente, choisissez « jamais » ; pour une offre de saison ou un salon, une date précise. Un lien annulé, lui, ne peut plus être payé, quelle que soit son expiration.

Prochaine étape

Avant de poser votre première affiche, imprimez-en une en mode test et faites vous-même le parcours client, du scan à la notification : Commencer en mode test. Pour régler chaque champ du lien derrière l'affiche, suivez notre guide pour créer un lien de paiement, et gardez la page des liens de paiement pour l'offre complète.