Skip to main content

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

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
150
points
231
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

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.

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