QR Code - OM
Description
QR Code est une solution de paiement avec un ensemble d'APIs flexibles, conçues pour tout type de commerce (vente en ligne ou physique). Elle permet d'accepter des paiements sur votre plateforme de manière rapide et sécurisée, pour vous et vos clients.
Quels sont les cas d'usage ?
- E-commerce
- Paiement à la caisse
- Jeux en ligne
- Billetterie
- etc.
En tant que partenaire, vous aurez la possibilité de choisir l'un de ces modes de facturation:
- QR Code with amount: Après scan du code QR avec l'application Orange Money, le client sera directement invité à confirmer le paiement, le montant de la transaction étant embarqué dans le paiement;
- QR Code without amount: Après scan du code QR avec l'application Orange Money, le client devra renseigner le montant à payer et valider la transaction.
À qui est destiné l'API ?
Toute entreprise désirant utiliser Orange Money pour accepter des paiements.
Si vous êtes un agrégateur de paiements, vous pouvez également l'utiliser et la proposer à vos partenaires.
Intégration rapide en trois étapes
Le service est facile à intégrer grâce à un accès en ligne, la possibilité de tester en toute autonomie et une documentation détaillée:
- S’inscrire pour créer son compte développeur;
- Créer une application pour tester rapidement la solution grâce aux multiples exemples disponibles dans la documentation;
- Envoyer ses documents administratifs depuis le site pour passer en production.
Documents administratifs à fournir
- Registre de Commerce et du Crédit Mobilier (RCCM)
- Numéro d'Identification National des Entreprises et des Associations (NINEA)
- Relevé d'Identité Bancaire (RIB)
- Carte Nationale d'Identité (CNI) ou Passeport de toutes les personnes mentionnées sur le RCCM et celui du gestionnaire du compte (celui qui effectue les opérations)
- Procuration du dirigeant social au profit du gestionnaire (si l'entreprise a un gestionnaire différent des personnes mentionnées sur le RCCM)
Conditions d’accès
Être une entreprise légalement enregistrée et fournir les documents ci-après dans le formulaire de complément d'informations (nécessite un accès à votre compte développeur):
- Registre de Commerce et du Crédit Mobilier (RCCM)
- Numéro d'Identification National des Entreprises et des Associations (NINEA)
- Relevé d'Identité Bancaire (RIB)
- Carte Nationale d'Identité (CNI) ou Passeport de toutes les personnes mentionnées sur le RCCM et celui du gestionnaire du compte (celui qui effectue les opérations)
- Procuration du dirigeant social au profit du gestionnaire (si l'entreprise a un gestionnaire différent des personnes mentionnées sur le RCCM)
Pour plus de détails, veuillez lire le contrat d’engagement à télécharger depuis le formulaire de complément d'informations.
Commencer
Dans cette page, vous trouverez toutes les étapes nécessaires pour tester facilement l'API.
Ci-après la liste des différentes requêtes incluses dans l'API:
- Authentification
- QR Code avec montant inclus
- QR Code sans montant inclus
Prérequis pour commencer
- Créer son compte développeur
- Créer une application sandbox
- Générer un token
Pour plus d’informations sur les prérequis, rendez-vous sur la page Premiers pas.
Paiement marchand par QR CODE
Pour générer un QR CODE, voici les informations dont vous aurez besoin:
- QR Code without amount : le code marchand, le nom du service et le montant à payer;
- QR Code with amount : le code marchand et le nom du service.
Toutes les URLs référencées dans la documentation suivent les liens ci-après:
Sandbox (Environnement test) : https://api.sandbox.orange-sonatel.com
Live (Environnement production) : https//api.orange-sonatel.com
Toutes les APIs fonctionnent en HTTPS pour garantir la sécurité et la confidentialité des données.
Ci-après les étapes à suivre pour bien tester l'API. Il faudra s'assurer d'avoir déjà généré la clé d'authentification (token).
- Choisir la méthode de paiement QR CODE à tester (avec ou sans montant);
- Exécuter la requête;
- Récupérer l'image du QR Code en Base64.
- Décrypter l'image précedemment obtenue. Vous pouvez par exemple utiliser ce site ou insérer directement dans votre code la balise HTML IMG Base64);
- Vous pouvez aussi récupérer le lien deeplink dans la réponse qui est une alternative au QR Code en environnement mobile. Il suffira de le mettre derrière un bouton;
- Ouvrir l'application Orange Money depuis votre smartphone et scanner le code QR pour confirmer le paiement.
Vous pouvez retrouver l'ensemble des requêtes précédentes dans la collection Postman ci-dessous (cliquez sur le bouton Run in Postman)
Le lien ci-dessus vous permet d'importer la collection dans votre espace de travail ou de le voir en public sur le navigateur. En cas de problème, vous pouvez installer séparément Postman, depuis ce lien.