Bien démarrer

Nous allons à présent voir les étapes nécessires pour bien démarrer avec votre projet d'intégration des APIs de MOALA.

L'intégration des APIs de MOALA peut se faire de deux manières, à savoir :

• Via nos SDK (Software Developement Kit)
• Via nos APIs REST
• Via nos liens de paiement

📡Intégration via les SDKs

Un SDK (Software Development Kit) est un ensemble d'outils, de bibliothèques de code permettant aux développeurs d'intégrer facilement de nouvelles fonctionnalités (ici les paiements) dans une application web ou mobile.

Pour fonctionner, un SDK doit être téléchargé et intégré au code source de notre application web ou mobile, puis il doit être configuré pour accéder au système distant ou local pour lequel il est configuré.

Généralement, cet accès se fait grâce à une authentification via username + mot de passe ou via toekn d'accès aux ressources.

Les SDKs simplifient l'intégration des nouveaux services car permettent aux développeurs d'épargner le temps d'intégration des API avecles différents retours possibles et les intégrations nécessires.

🔌Intégration via les API REST

Une API (Application Programming Interface) REST (Representational State Transfer) est un ensemble d'interfaces accessibles via une URL sur le web.

Les APIs permettent l'intégration entre les systèmes, en permettant un control beaucoup plus fin pour l'accès aux ressources qu'il fournit.

En effet, les APIs fournissent des fonctionnalités similaires aux SDKs, à l'exception qu'avec les APIs on a le contrôle total sur le formatage des messages envoyés aux endpoints, sur les réponses retournées par les appels d'APIs et sur les intégrations possibles.

Pour utiliser nos APIs, vous devez vous authentifier avec l'un des moyens suivants :

• username + mot de passe
• token d'authentification

🔗Intégration via les liens de paiement

Un lien de paiement est une URL unique générée par un prestataire de paiement ou un agrégateur de paiement. Il permet à un client d’effectuer un paiement en ligne sans avoir à intégrer directement un module de paiement sur un site web ou une application.

Les étapes d'utilisation d'un lien de paiement sont les suivantes :

1. Génération du lien de paiement

Le marchand crée un lien via l'interface de MOALA ou de son API. Ce lien contient les informations essentielles telles que la devise, le montant, le nom du client, etc

2. Envoi du lien au client

Le lien peut être envoyé par SMS, Mail, Whatsapp, etc ou même affiché sous forme de QR Code

https://api.moala.africa/pay?order=12345&amount=100&currency=XAF

3. Paiement par le client

Le client clique sur le lien et est redirigé vers une page de paiement sécurisée.

Il choisit son mode de paiement conforme à l'agrégateur (OM, MOMO, Airtel Money)

Il valide le paiement en entrant les informations requises (mot de passe ou PIN secret)

4. Confirmation du paiement

Une fois le paiement effectué par le client, l'agrégateur notifie le marchand via une redirection vers une page de confirmation.

Ainsi le marchand peut continuer avec le traitement de la commande.