Aller au contenu principal

Paiement de facture via le SDK (Php)

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 paiement de facture.

Prérequis​

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

  • Un compte sur le portail MOALA avec les permissions nécessaires pour effectuer des dépôts.
  • Php 7.2 ou supérieur
  • Composer pour gérer les dépendances
  • Avoir téléchargé et intégré le SDK ici : SDK Moala Php

Installation​

Vous pouvez installer le SDK via Composer. Ajoutez le SDK à votre projet via la commande suivante :

composer require bitkap/php-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.

use MoalaSDK\MoalaClient;

$base_url = "https://api.moala.africa";
$appKey = "your_app_key";
$secretKey = "your_secret_key";

$client = new MoalaClient($base_url, $appKey, $secretKey);

2. Effectuer le paiement​

Nous allons à présent effectuer une opération de paiement de facture en utilisant le SDK de MOALA.

$payment = $client->cashout($phoneNumber, $serviceCode, $amount, $partnerId);
print_r($payment);
info

Les serviceCode autorisés 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 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 de méthode du SDK.

$status = $client->checkTransaction($partnerId);
print_r($status);

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 dépôt de 500F depuis un numéro Orange Money.

use MoalaSDK\MoalaClient;

$base_url = "https://api.moala.africa";
$appKey = "your_app_key";
$secretKey = "your_secret_key";

// Authentification
$client = new MoalaClient($base_url, $appKey, $secretKey);

// Réalisation du paiement
$serviceCode = "CASHOUT_ORANGE_CM";
$phoneNumber = "XXXXXXXXX";
$partnerId = "xxxxxxxx";
$amount = 1000;
$payment = $client->cashout($phoneNumber, $serviceCode, $amount, $partnerId);
print_r($payment);

// Vérification du statut du paiement
$status = $client->checkTransaction($partnerId);
print_r($status);

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 paiement de facture.