Encaisser en ligne avec l'API SAMA Money : 0,3 % par paiement
Comment fonctionne l’encaissement en ligne ?
Votre client reçoit une demande de paiement et la confirme sur son téléphone, avec son code secret : vous ne le voyez jamais. Votre système est ensuite informé du résultat par une notification automatique, que l’on appelle un webhook.
En pratique, le parcours tient en trois temps :
- Votre système crée la demande de paiement pour le montant de la commande.
- Votre client la reçoit et la confirme sur son téléphone.
- Votre système reçoit le résultat par notification et peut valider la commande.
Le QR code est réservé au paiement en présence du client. En ligne, on utilise la demande de paiement.
Comment démarrer en quatre étapes ?
- Ouvrez un compte sur l’espace développeurs, developer.sama.money.
- Testez avec une clé d’essai dans le bac à sable : l’argent y est fictif, aucune donnée réelle n’y circule, et les numéros de test servent à simuler la confirmation.
- Demandez la production : SAMA Money vérifie votre entreprise ou votre activité.
- Mettez votre page de paiement en ligne avec la mention « Paiement opéré par SAMA Money, établissement émetteur de monnaie électronique agréé par la BCEAO ».
La clé d’essai ne déplace aucun argent réel. La clé de production permet des opérations réelles et n’est activée qu’après l’approbation de votre dossier.
Quels documents préparer pour la vérification de votre entreprise ?
- La dénomination commerciale ou sociale, c’est-à-dire le nom sous lequel vous exercez.
- Un numéro RCCM ou NIF, selon votre situation.
- La ville et le pays de résidence ou d’établissement.
- La pièce d’identité du responsable.
- Selon le cas, des justificatifs complémentaires : statuts, pouvoirs du représentant, bénéficiaires effectifs.
Quels accès sont disponibles ?
| Accès | État | Ce qu’il permet |
|---|---|---|
| Clé d’essai et bac à sable | disponible, ouvert à tous les développeurs | tester l’API avec de l’argent fictif, sans aucune donnée réelle |
| Clé de production (compte complet) | disponible après vérification de votre entreprise | des opérations réelles, avec des plafonds selon le profil de l’entreprise |
Pour encaisser en ligne par demande de paiement, il faut un compte complet. Pour PI-SPI par API, renseignez-vous auprès d’un conseiller. Les entreprises établies au Mali, et leurs filiales, peuvent ouvrir un compte complet après vérification. Les développeurs et les sociétés établis hors du Mali peuvent utiliser gratuitement le bac à sable. Les autres situations sont étudiées au cas par cas, dans le respect de la réglementation des changes de l’UEMOA.
Combien coûte l’encaissement en ligne ?
| Service | Tarif | Qui paie |
|---|---|---|
| Encaissement en ligne, par demande de paiement ou par API | 0,3 % du montant encaissé | le marchand |
| Virement sortant depuis un compte entreprise ou administration | négocié au cas par cas | l’entreprise |
| Virement reçu, transfert entre comptes SAMA, demande de paiement | gratuit | personne |
Exemple : pour 100 000 F encaissés, les frais sont de 300 F, à la charge du marchand. La personne qui paie ne supporte aucun frais.
PI-SPI par API
L’accès à PI-SPI par API est disponible en bac à sable pour préparer votre intégration. Pour la production, renseignez-vous auprès d’un conseiller.
En attendant, l’API de paiement de SAMA Money, hors PI-SPI, est utilisable après vérification de votre entreprise. L’encaissement en ligne par PI-SPI est réservé aux entreprises et aux administrations : un commerçant personne physique n’y a pas accès.
Comment sécuriser votre intégration ?
- Gardez votre clé secrète sur votre serveur, jamais dans une page web, dans une application mobile ni dans un code publié en ligne.
- Vérifiez la signature de chaque notification reçue.
- Envoyez un identifiant unique pour chaque opération monétaire : si vous rejouez la même requête, la même réponse revient, sans doublon.
- En cas d’erreur, relevez l’identifiant de requête renvoyé : le support en a besoin.
Un tiers qui encaisse pour le compte d’autres personnes (place de marché, agrégateur) exerce un service de paiement soumis à l’agrément de la BCEAO : ce cas n’est pas couvert par ce guide.
Questions fréquentes
Puis-je tester l’API sans argent réel ?
Oui. Le bac à sable fonctionne avec de l’argent fictif et une clé d’essai, et il est ouvert à tous les développeurs, y compris aux sociétés établies hors du Mali.
Puis-je obtenir des clés de production tout de suite ?
Les clés de production sont activées après la vérification de votre entreprise et l’approbation de votre dossier.
Puis-je encaisser en ligne avec un QR code ?
Non. Le QR code ne sert qu’en présence du client. En ligne, on utilise la demande de paiement.
Qui paie les 0,3 % ?
Le marchand qui encaisse. La personne qui paie ne supporte aucun frais.
Faut-il un compte vérifié pour encaisser en ligne par PI-SPI ?
Oui : un compte professionnel vérifié, tenu chez SAMA Money. Pour PI-SPI par API, renseignez-vous auprès d’un conseiller.
Pour aller plus loin
- « Ce qui est gratuit chez SAMA Money » : la liste complète des gratuités.
- « Plafonds des virements instantanés PI-SPI » : les limites par virement.
- « Le virement instantané PI-SPI expliqué simplement, pas à pas » : comprendre PI-SPI.
- « Paiements de masse : salaires, bourses, pensions et aides » : payer de nombreux bénéficiaires.
- « Compte simple ou compte vérifié : lequel choisir et pourquoi ? » : la vérification d’identité.
- « Encaisser par mobile money en boutique avec SAMA Money : le guide » : encaisser en boutique.
- « Frais du mobile money : qui paie quoi et quand c’est gratuit » : tous les frais en un coup d’œil.
Article de SAMA Académie, rédigé par SAMA Money. Les frais et plafonds indiqués sont ceux de la grille en vigueur : voir les tarifs.