gopay 0.2.1
gopay: ^0.2.1 copied to clipboard
Official GoPAY SDK for Flutter & Dart. Accept Mobile Money payments (M-Pesa, Airtel Money, Orange Money) and send payouts in DRC (CDF/USD). Cross-platform with Web and WASM support.
GoPAY Flutter & Dart SDK 💙 #
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
GETsont automatiquement rejouées en cas d'erreurs réseau transitoires avec un backoff exponentiel et jitter. Les requêtesPOSTetDELETEne 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.