gopay 0.2.2
gopay: ^0.2.2 copied to clipboard
Official GoPAY SDK for Flutter & Dart. Accept Mobile Money payments (M-Pesa, Airtel, Orange) and send payouts in DRC. Cross-platform, Web & WASM ready.
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.