API Marchand
Encaisser : paiements, liens de paiement, QR codes interopérables, demandes de paiement et retours de fonds.
À quoi sert cette API
L'API Marchand couvre l'encaissement au sens large : du paiement unitaire au QR code affiché en point de vente, en passant par les liens de paiement partageables et les demandes de paiement récurrentes.
Tous les montants sont exprimés en unité entière de la devise — 15000 pour 15 000 XOF. Le franc CFA n'ayant pas de subdivision en usage, aucune conversion en centimes n'est appliquée.
Endpoints
| Méthode | Endpoint | Description |
|---|---|---|
| POST | /v1/payments | Créer un paiement |
| GET | /v1/payments/{id} | Consulter le statut d'un paiement |
| POST | /v1/payment-links | Générer un lien de paiement |
| POST | /v1/qr-codes | Générer un QR code interopérable pour l'encaissement |
| POST | /v1/payment-requests | Initier une demande de paiement (RTP), ponctuelle ou récurrente |
| POST | /v1/refunds | Initier un retour de fonds sur un paiement existant |
Ces endpoints sont en cours de spécification. Un seul endpoint d'encaissement est aujourd'hui déployé en sandbox : la création de session de checkout.
Disponible maintenant depuis l'espace marchand
Les fonctions d'encaissement sont déjà utilisables via l'interface, en attendant leur exposition programmatique :
- Liens de paiement — créer et partager un lien d'encaissement
- Abonnements — paiements récurrents, échéances simulées en sandbox
- Transactions — historique et statut des encaissements
QR codes interopérables
La génération de QR codes EMV conformes PI-SPI ne nécessite pas d'appel réseau : le SDK QR Code de l'écosystème PI-SPI produit le payload côté client, dans quatre langages.