Cash In - OM

Description

Le mobile money se développe fortement en Afrique, grâce aux acteurs locaux et aux grandes enseignes internationales. Ainsi,  pour répondre à la forte attente des populations et pour innover davantage, les acteurs ont besoin d’accéder directement aux services des opérateurs.

Ces solutions APIs sont mises en place pour :

  • Répondre de façon efficiente  aux besoins d’ouverture des services Orange Money face aux défis imposés par la transformation digitale.
  • Proposer une architecture totalement orientée services et de façon sécurisée.
  • Exposer les services sous forme d’API (Application Programming Interface) de façon standardisée.

L’API CASH IN (dépôt automatique d’argent dans un compte client) d’Orange Money est maintenant disponible pour les distributeurs.

Ce service  permet d'effectuer un dépôt d’argent dans un compte client. En d’autres termes, c’est le positionnement, par un commerçant, d’un montant à destination du compte Orange Money d’un client.

Le distributeur aura deux possibilités d’utilisation :

  • Dépôt unitaire: Exécuter une requête de dépôt d’un montant défini pour un client.
  • Dépôt multiple (BULK CASH IN) : Exécuter dans une seule requête plusieurs dépôts de montants différents à des destinataires tout aussi différents.

 

À qui est destiné l’API ?

 

Si vous êtes déjà distributeur Orange Money, ou que vous souhaitez le devenir, rejoignez un écosystème sécurisé en vous inscrivant sur ce site.

 

 

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 :
 

  1. S’inscrire pour créer son compte développeur.
  2. Créer une application pour tester rapidement la solution grâce aux multiples exemples disponibles dans la documentation.
  3. Envoyer ses documents administratifs depuis le site pour passer en production.

 

 

Conditions d’accès

 

Etre 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)
  • 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

Avec les APIs d'Orange et quelques lignes de code, vous pouvez très facilement effectuer des dépôts d’argent sur un compte client Orange Money après une authentification sécurisée, ensuite vérifier le statut de la transaction et votre solde.

Ci-après la liste des APIs incluses :

  • Authentification
  • Récupération de la clé publique de cryptage du code PIN
  • Changement de code PIN
  • Consultation de solde
  • Cash In
  • Historique des transactions
  • Consultation du statut d’une transaction


Prérequis pour commencer
 

  1. Créer son compte développeur
  2. Créer une application de test
  3. Générer un token
     

Pour plus d’informations sur les prérequis, rendez-vous sur la page Premiers pas.

 


Cash In (dépôt d’argent vers un compte Orange Money)

 

Pour faire un dépôt, vous aurez besoin d’un numéro de distributeur avec du cash, d’un numéro client, du montant à déposer, et du code PIN crypté.

 

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).

 

  1. Récupérer des numéros de test (client et distributeur)
  2. Récupérer la clé publique pour crypter le code PIN (fourni par la requête de demande de numéros de test)
  3. Crypter le code PIN en RSA en utilisant par exemple ce site.
  4. Vérifier les soldes des numéros de test
  5. Exécuter la requête en renseignant au préalable les différents paramètres
  6. Revérifier les soldes des numéros utilisés dans la transaction
  7. Utiliser les requêtes de recherche pour consulter les détails d'une transaction, rechercher des transactions sur une période, etc.

 

Pour tester plus simplement les APIs, vous pouvez utiliser le logiciel 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.

 

 

/sites/default/files/apidoc_specs/api-documentation2.json