Effectuer un dépôt via le SDK (Js)

Vous pouvez utiliser nos SDK dans différents langages pour effectuer des opérations avec Moala :

Dans ce tutoriel, nous allons vous présenter une approche simple pour intégrer les SDKs de MOALA dans le but de faire une opération de dépôt d'argent.

Prérequis

Avant de commencer, assurez-vous d'avoir les éléments suivants :

Un compte sur le portail MOALA avec des permissions nécessaires pour effectuer des dépôts. Vous pouvez obtenir un compte Moala en suivant les étapes précisées ici Obtenir les clés d'accès
Node js 18 ou supérieurs
npm pour gérer les dépendances
Avoir téléchargé et intégré le SDK ici : SDK Moala Javascript

Installation

Vous pouvez installer le SDK via NPM.

Ajoutez le SDK à votre projet via la commande suivante :

npm install js-moala

1. Authentification

L'authentification au SDK de Moala se fait en configurant le client du SDK avec votre clé d'API et une clé secrète.

const { createClient } = require('js-moala');

const baseUrl = 'https://api.moala.africa';
const appKey = 'your_app_key';
const secretKey = 'your_secret_key';

const client = createClient(baseUrl, appKey, secretKey);

Une fois la configuration terminée, vous pouvez commencer à utiliser le SDK.

2. Vérifier les KYC du client

Avant d'effectuer le dépôt d'argent, il est important d'effectuer une vérification des KYC afin de se rassurer que le dépôt ser fait chez le bon destinataire.

(async () => {
    try {
        const transaction = await client.kyc(phoneNumber, serviceCode);
        console.log('Transaction:', transaction);
    } catch (error) {
        console.error('Error:', error);
    }
})();

info

Les serviceCode autorisés pour cette méthode du SDK sont les suivants :

CASHOUT_MTN_CM: Cashout MTN Cameroun
CASHOUT_ORANGE_CM: Cashout Orange Cameroun
CASHOUT_AIRTEL_GA: Cashout Airtel Gabon
CASHOUT_MOOV_GA: Cashout Airtel Gabon
PAIEMENTMARCHAND_MTN_CM: Paiement marchand MTN Cameroun
PAIEMENTMARCHAND_ORANGE_CM: Paiement marchand Orange Cameroun
PAIEMENTMARCHAND_AIRTEL_GA: Paiement marchand Airtel Gabon
PAIEMENTMARCHAND_MOOV_GA: Paiement marchand Moov Gabon

3. Effectuer le dépôt

Nous allons à présent effectuer une opération de dépôt d'argent en utilisant le SDK de MOALA.

(async () => {
    try {
        const cashinResult = await client.cashin('phoneNumber', 'serviceCode', amount, 'partnerId');
        console.log('Cashin:', cashinResult);
    } catch (error) {
        console.error('Error:', error);
    }
})();

info

Les serviceCode autorisés pour cette méthode du SDK sont les suivants :

CASHIN_MTN_CM: Cashout MTN Cameroun
CASHIN_ORANGE_CM: Cashout Orange Cameroun
CASHIN_AIRTEL_GA: Cashout Airtel Gabon
CASHIN_MOOV_GA: Cashout Airtel Gabon
PAIEMENTMARCHAND_MTN_CM: Paiement marchand MTN Cameroun
PAIEMENTMARCHAND_ORANGE_CM: Paiement marchand Orange Cameroun
PAIEMENTMARCHAND_AIRTEL_GA: Paiement marchand Airtel Gabon
PAIEMENTMARCHAND_MOOV_GA: Paiement marchand Moov Gabon

attention

Le champ partnerId doit être unique pour chaque transaction, sinon l'envoi de la requête va échouer.

3. Vérifier le statut du dépôt

Une fois que la requête de dépôt a été envoyée, on peut vérifier le succès de l'opération en faisant un nouvel appel d'API.

(async () => {
    try {
        const status = await client.checkTransaction(partnerId);
        console.log('Status:', status);
    } catch (error) {
        console.error('Error:', error);
    }
})();

4. Conclusion

Arrivés au terme de ce tutoriel, vous savez maintenant comment intégrer les APIs de MOALA pour réaliser une opération de dépôt d'argent.

Prérequis​

Installation​

1. Authentification​

2. Vérifier les KYC du client​

3. Effectuer le dépôt​

3. Vérifier le statut du dépôt​

4. Conclusion​