GoPAY Flutter & Dart SDK 💙

pub package pub points License: MIT

SDK officiel Dart & Flutter pour l'intégration de la passerelle de paiement GoPAY Mobile Money (Paiements et Payouts en République Démocratique du Congo - RDC).

Acceptation des paiements mobiles : M-Pesa (Vodacom), Airtel Money, Orange Money et Afrimoney en devises Franc Congolais (CDF) et Dollar Américain (USD).

Compatible sur toutes les plateformes : Android, iOS, Web, Windows, macOS et Linux (prĂȘt pour WASM).


📩 Installation

Dans le dossier de votre projet Flutter :

flutter pub add gopay

Ou ajoutez manuellement dans votre pubspec.yaml :

dependencies:
  gopay: ^0.2.1

⚡ DĂ©marrage Rapide

1. Initialiser le client GoPAY

import 'package:gopay/gopay.dart';

final gopay = GoPayClient(const GoPayConfig(
  baseUrl: 'https://gopay.gooomart.com', // Optionnel (HTTPS obligatoire)
  paymentApiKey: 'VOTRE_PAYMENT_API_KEY',
  paymentSecretKey: 'VOTRE_PAYMENT_SECRET_KEY',
  payoutApiKey: 'VOTRE_PAYOUT_API_KEY', // Optionnel si aucun transfert sortant
));

2. Initier une demande de paiement (Mobile Money)

final payment = await gopay.initPayment(
  4000.0,
  'CDF',          // 'CDF' ou 'USD'
  '+243825000000',
  'REF-CMD-1001',
);

if (payment.success) {
  print('Transaction initiée avec succÚs: ${payment.transId}');
} else {
  print('Échec: ${payment.message} (Code: ${payment.errorCode})');
}

3. Vérifier l'état d'un paiement

final check = await gopay.checkPayment('REF-CMD-1001');
print('Statut de la transaction: ${check.transactionStatus}'); // "success", "pending", etc.

4. Payout (Transferts de fonds sortants)

Note

Pour des raisons de sécurité, nous recommandons de traiter les payouts depuis un serveur backend sécurisé afin de ne pas exposer votre payoutApiKey dans une application mobile décompilable.

// 1. Consulter le solde du portefeuille Payout
final balance = await gopay.getPayoutBalance();
if (balance.success) {
  print('Solde disponible: ${balance.balance} ${balance.currency}');
}

// 2. Envoyer un transfert groupé
final transfer = await gopay.sendPayoutTransfer(
  1500.0,
  'CDF',
  ['+243825000000'],
  ['TRANSFERT-REF-001'],
);

🔒 SĂ©curitĂ© et Signature Cryptographique

  • Signature HMAC-SHA256 : Toutes les requĂȘtes sont signĂ©es avec un horodatage (x-timestamp) et un jeton anti-rejeu (x-nonce).
  • Retry Automatique : Les requĂȘtes idempotentes GET sont automatiquement rejouĂ©es en cas d'erreurs rĂ©seau transitoires avec un backoff exponentiel et jitter. Les requĂȘtes POST et DELETE ne sont jamais rejouĂ©es pour Ă©viter les doubles dĂ©bits.

đŸ§Ș Exemple ExĂ©cutable

Un exemple complet et prĂȘt Ă  l'emploi est disponible dans example/main.dart.


📄 Licence

Ce package est distribué sous licence MIT. Propulsé par GoPAY Gateway.

Libraries

gopay
SDK officiel pour intégrer la passerelle de paiement GoPAY Mobile Money dans vos applications Dart et Flutter.
io
Transport réseau basé sur dart:io pour applications Flutter Android, iOS et Desktop.