Welloo SDK

*Welloo SDK* est un SDK Flutter qui facilite l'intégration du service de paiement *Welloo* dans vos applications mobiles. Il fournit des widgets, configurer et exécuter des paiements de manière sécurisée.

✨ Fonctionnalités #

• 💳 Initialisation sécurisée du SDK
• 🔗 Gestion sécurisée des transactions (dépôt, transfert)
• 📦 Intégration rapide dans n'importe quelle app Flutter
• 🧩 Compatible Android & iOS
• 🔄 Deep link automatique pour retour depuis Wave
• ⚡ Fallback intelligent si deep link non configuré (détection lifecycle)
• 🔔 Vérification automatique du statut (polling 3s)
• 🎨 Interface moderne avec animations

🔗 Les Etapes #

L'utilisation du package est la plus simple possible, dans son utilisation, il s'agit d'invoquer celui-ci avec :

• Les paramétres d'initialisation du guichet
• Le callback d'attente du retour de paiement
• Le callback d'écoute d'erreur d'exécution

Initialisation du Package #

Pour fonctionner, le sdk doit impérativement recevoir des données telles que :

• accessToken | L'access Token | Chaine de caractère | Obligatoire
• refreshToken | Le refresh Token | Chaine de caractère | Obligatoire

👩‍💻 Utilisation du Package #

En resumé, le package s'utilise par le biais d'un appel de widget :

*/Pour Effectuer un dépôt */ 
WellooDeposit(
    accessToken: "ACCESS_TOKEN",
    refreshToken: "RESFRESH_TOKEN",
    waitResponse: (response) {
        print(response);
    }
    onError: (error) {
        print(error);
    }
  ) 

📱 Aperçu #

Dépôt

🛠 Installation #

Exécutez cette commande :

Avec Flutter :

flutter pub add welloo_sdk

ou Ajoutez le package à votre fichier pubspec.yaml :

dependencies:
  welloo_sdk: ^0.0.46

⚙️ Configuration Deep Links (Optionnel mais Recommandé) #

Pour que l'app se rouvre automatiquement après le paiement Wave, configurez les deep links :

Android - android/app/src/main/AndroidManifest.xml #

<activity android:name=".MainActivity" android:launchMode="singleTop">
    <!-- Vos intent-filters existants -->

    <!-- Deep link pour Welloo SDK -->
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <category android:name="android.intent.category.BROWSABLE"/>
        <data android:scheme="https" android:host="finapay.net"/>
    </intent-filter>
</activity>

iOS - ios/Runner/Info.plist #

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>https</string>
        </array>
        <key>CFBundleURLName</key>
        <string>net.finapay</string>
    </dict>
</array>
<key>FlutterDeepLinkingEnabled</key>
<true/>

Note : Même sans deep link configuré, le SDK fonctionne ! Il détectera automatiquement le retour en foreground et vérifiera le statut de la transaction.

📚 Documentation Complète #

• 📖 Guide d'intégration détaillé
• 🔗 Configuration Deep Links avancée
• 💻 Exemple complet d'utilisation

Développé avec ❤️ par l'équipe Finapay