Skip to main content

gopay 0.2.2 copy "gopay: ^0.2.2" to clipboard
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 💙 #

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.

1
likes
160
points
231
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

Official GoPAY SDK for Flutter & Dart. Accept Mobile Money payments (M-Pesa, Airtel, Orange) and send payouts in DRC. Cross-platform, Web & WASM ready.

Homepage
Repository (GitHub)
View/report issues

Topics

#payment #mobile-money #fintech #payout #mpesa

License

MIT (license)

Dependencies

crypto, http

More

Packages that depend on gopay