Création des API Key

Afin d'intégrer les APIs de MOALA via les SDKs et les APIs REST il est nécessaire de créer une clé d'API sur le portail de MOALA.

Ce portail est accessible ici : Portail MOALA

info

Afin d'utiliser les SDK que nous présenterons ci-dessous, il est nécessaire d'avoir un compte sur notre backoffice.

Ce compte est créé lorsque vous avez validé toutes les formalités administratives présentées dans la section précédente Prérequis et procédure d'intégration

Ci-dessous vous verrez les étapes nécessires à la création d'un API Key sur ce portail.

1. Accès au portail

L'accès au portail se fait en accédant à son URL Portail MOALA dans votre navigateur. Vous arriverez sur cette page, et cliquez sur Login.

2. Authentification

Une fois que vous avez cliqué sur Login, vous êtes redirigé vers une autre page où on vous demandera de saisir le identifiants de connexion au portail :

• Nom d'utilisateur : le nom d'utilisateur transmis par le support technique de Moala
• Mot de passe : le mot de passe qui accompagne le username, transmis par le support technique de Moala

3. Création d'API Key

Une fois que vous vous êtes correctement authentifié sur le portail, vous accédez à la page suivante :

Sur cette page, cliquez sur le bouton Create + et un formulaire de création de la clé d'API sera ouvert.

4. Remplir le formulaire

Une fois que le formulaire de création de l'API Key s'ouvre, vous devez remplir tous les champs obligatoires, à savoir :

• Rôle: vous choissez les rôles auquel l'API aura accès
  • deposit : afin de pouvoir effectuer des dépôt via cette API
  • withdrawal : afin de pouvoir effectuer des retraits via cette API
  • checking : afin de pouvoir consulter son solde via cette API
• IP address: l'adresse IP du serveur
• Notification URL: l'url utilisée pour notifier le client en cas de succès/échec de la transaction
• Status: définit si l'API Key peut être utilisée, selon son statut activée ou déseactivée

info

Notification URL : cette url est un webhook de votre application, que vous pouvez configurer lors de l'intégration de notre API ou SDK.

Après l'exécution d'une requête sur une de nos APIs, le backend de Moala va envoyer une requête POST vers cette url afin de vous notifier de après l'exécution de votre requête.

La requête POST envoyée par le backend contiendra des informations au format JSON avec la structure suivante :

{
  "status": "RECEIVED",
  "amount": "XXXXXX",
  "partnerId": "YYYYYYYYYYYYYYYY",
  "operatorId": "ZZZZZZZZZZZZZZZ",
  "serviceCode": "PAIEMENTMARCHAND_ORANGE_CM",
  "message": null
}

Une fois le formulaire rempli, cliquez sur Save.

4. Création réussie

Une fois la création de la clé de l'API réussie, vous verrez la fenêtre de succès s'ouvrir :

5. Lister les API Key

Vous pouvez voir que la clé d'API est bien créée et est disponible dans l'interface ci-dessous :