Aller au contenu principal

Effectuer un retrait via l'API REST (Java)

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 retrait 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 retraits. Vous pouvez obtenir un compte Moala en suivant les étapes précisées ici Obtenir les clés d'accès
  • Un environnement de développement avec Java installé
  • Avoir téléchargé et intégré le SDK ici : SDK Moala Java

Installation​

Vous pouvez installer le SDK via Maven

<dependency>
    <groupId>africa.moala</groupId>
    <artifactId>sdkmoala</artifactId>
    <version>1.0</version>
</dependency>

Ajoutez le SDK à votre projet en utilisant la commande :

mvn package

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.

import africa.moala;

String urlApi = "https://api.moala.africa";
String appKey = "your_app_key";
String secretKey = "your_secret_key";

MoalaClient moalaClient = new MoalaClient(appKey, secretKey, urlApi);

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

2. Effectuer le retrait​

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

TransactionView transactionView = moalaClient.cashout("phoneNumber","serviceCode",amount, "partnerId");
System.out.println(transactionView);
info

Les serviceCode autorisés pour ce 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
attention

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

3. Vérifier le statut de l'opération​

Une fois que la requête de retrait a été envoyée, on peut vérifier le succès de l'opération en exécutant une autre méthode du SDK.

TransactionView transactionView = moalaClient.checkTransaction("partnerId");
System.out.println(transactionView);

4. Exécuter le code​

A présent, nous allons exécuter le code présenté ci-dessus.

Pour cela, nous allons tenter de faire un retrait de 500F.

import africa.moala;

String urlApi = "https://api.moala.africa";
String appKey = "your_app_key";
String secretKey = "your_secret_key";

// Initialisation du client
MoalaClient moalaClient = new MoalaClient(appKey, secretKey, urlApi);

// Réalisation du retrait
String phoneNumber = "XXXXXXXX";
String serviceCode = "CASHIN_ORANGE_CM";
Float amount = 500.0;
String partnerId = "partnerId";
TransactionView transactionView = moalaClient.cashout(phoneNumber,serviceCode,amount, partnerId);
System.out.println(transactionView);

// Vérification du statut du retrait
TransactionView transactionView = moalaClient.checkTransaction(partnerId);
System.out.println(transactionView);
info

Les Service Code disponibles pour les appels d'APIs sont les suivants :

  • CASHIN_MTN_CM: cashin MTN Cameroun
  • CASHIN_ORANGE_CM: cashin orange Cameroun
  • CASHIN_AIRTEL_GA: cashin airtel Gabon
  • PAIEMENTMARCHAND_AIRTEL_GA: payment Marchand airtel Gabon
  • PAIEMENTMARCHAND_ORANGE_CM: payment Marchand orange Cameroun
  • PAIEMENTMARCHAND_MTN_CM: payment Marchand MTN Cameroun

5. 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 retrait d'argent.