maishapay_payment_plugin_v1_0 💳 #

🌟 Vue d'Ensemble #

maishapay_payment_plugin_v1_0 est un plugin Flutter simple et sécurisé qui fournit une interface unifiée pour intégrer les passerelles de paiement populaires (Mobile monney, Visa, Mastercard, Stripe, PayPal, etc.) dans votre application mobile. Il gère la tokenisation sécurisée et les interfaces utilisateur natives (si disponibles) pour une expérience utilisateur optimale.

✨ Fonctionnalités Clés #

• Multi-Passerelle : Support intégré pour les principaux fournisseurs de paiement.
• Tokenisation Automatique : Gère la conversion sécurisée des informations de carte.
• Support 3D Secure : Intégration des flux de vérification 3D Secure.
• Faible Latence : Optimisé pour une exécution rapide des transactions.

🚀 Démarrage Rapide #

1. Installation #

Ajoutez maishapay_payment_plugin à votre fichier pubspec.yaml :

dependencies:
  maishapay_payment_plugin: ^1.0.0

### 2. Configuration Spécifique aux Plateformes

Ce plugin nécessite une configuration native minimale avant la première utilisation.

Plateforme, Étapes Requises
iOS,Configuration de l'URL Scheme pour les retours d'application.
Android,Ajout de la clé publique de votre passerelle au AndroidManifest.xml.

### 3. Utilisation de Base (Paiement Unique)

import 'package:maishapay_payment_plugin_v1_0/payment_plugin.dart';

final String apiKey = "";
final String secreteKey = "";
final double amount = 100.0;
final String orderId = 'CMD-${DateTime.now().millisecondsSinceEpoch}';
final String callbackUrl = "https://your_domaine.com/mobile_calback";

```void _launchPayment(BuildContext context) async {
    try {
      final result = await PaymentPlugin.launchQuickPayment(
        context: context,
        apiKey: apiKey,
        amount: amount,
        orderId: orderId,
        customerEmail: '[email protected]',
        customerPhone: '+221771234567',
        currency: "CDF",
        customerName: "Grace Divine",
        apisecretekey: secreteKey,
        callbackUrl: callbackUrl,
        gatwaymode: "1",
        customerFirstname: "Grace",
        customerLastname: "Divine",
        customerAddress: "306 av de la gombe",
        customerCity: "Kinshasa",
      );

      // Afficher le résultat
      showDialog(
        context: context,
        builder: (context) => AlertDialog(
          title: Text('Résultat du Paiement'),
          content: Text(
            'Status: ${result?.transactionStatus}\n'
            'Transaction ID: ${result?.transactionId}\n'
            'Amount: ${result?.order.cost.amount} ${result?.order.cost.currency}\n'
            'Message: ${result?.transactionStatus}',
          ),
          actions: [
            TextButton(
              onPressed: () => Navigator.of(context).pop(),
              child: Text('OK'),
            ),
          ],
        ),
      );
    } catch (e) {
      print('Erreur: $e');
    }
}


⚙️ Configuration Native Détaillée
Pour garantir un flux de paiement complet (y compris les redirections 3D Secure), suivez ces étapes :

🍏 iOS
Ouvrez le fichier ios/Runner/Info.plist.

Ajoutez un URL Scheme pour permettre le retour de la passerelle de paiement à votre application. (Détails et exemple de code dans le dossier example/).

<!--  // Dans ios/Runner/Info.plist -->
<key>io.flutter.embedded_views_preview</key>
	<true/>
	<key>NSAppTransportSecurity</key>
	<dict>
		<key>NSAllowsArbitraryLoads</key>
	<true/>
</dict>


🤖 Android
Ouvrez le fichier android/app/src/main/AndroidManifest.xml.

Dans le tag <manifest>, ajoutez une balise <uses-permission> pour la permission Internet :
<uses-permission android:name="android.permission.INTERNET" />


📚 API de Référence
Consultez la Référence API Complète sur pub.dev pour la liste complète des méthodes, classes et constantes disponibles, y compris :

PaymentPlugin.launchQuickPayment(
        required BuildContext context,
        required String apiKey,
        required String apisecretekey,
        String customerName = '',
        required double amount,
        required String orderId,
        required String customerEmail,
        required String currency,
        String customerPhone = '',
        required String callbackUrl,
        required String gatwaymode,
        String customerFirstname = '',
        String customerLastname = '',
        String customerAddress = '',
        String customerCity = '',
      ) : @return RequestEntity : Pour capturer un paiement autorisé.

PaymentPlugin.searchPayment({
    String? transactionId,
    required String apiKey,
    required String secretApiKey,
    required String orderId,
    required String gatwaymode,
  }) : @return RequestEntity : Pour effectuer la recherche d'un payment.

PaymentGateway : L'énumération des passerelles supportées.

🤝 Contribuer
Les contributions sont les bienvenues ! Veuillez consulter les Lignes Directrices de Contribution pour savoir comment soumettre des pull requests ou signaler des problèmes (issues).

📄 Licence
Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.