SDK Android

Le SDK Android est conçu afin de permettre l'intégration de KKiaPay au sein de votre application mobile.

L'intégration du SDK Android dans votre application mobile nécessitera l'ajout dans votre fichier build.gradle de ces quelques lignes de code :

build.gradle

implementation 'co.opensi.kkiapay:kkiapay:1.+'

Nécessaire pour la suite de l'intégration, votre clé API est disponible sur votre tableau de bord.

Dans la classe singleton de votre application, celle qui étend la classe Application du framework Android, ajoutez dans la méthode onCreate le code suivant :

Kotlin

MyApplication.kt

Kkiapay.init(applicationContext,"<votre-kkiapay-api-key>",
            SdkConfig(themeColor = R.color.colorPrimary, 
            imageResource = R.raw.votre_logo,
            enableSandbox = true))

Initialisé à true, l'attribut enableSandbox vous permet de passer en mode test.

Est optionnel, le paramètre SdkConfig de la fonction ci-dessus. Il permet la configuration de vos préférences.

Java

MyApplication.java

Kkiapay.INSTANCE.init(this,"<votre-kkiapay-api-key>",
                new SdkConfig(R.raw.votre_logo,
                 R.color.colorPrimary,
                 enableSandbox = true));

Est optionnel, le paramètre SdkConfig de la fonction ci-dessus. Il permet la configuration de vos préférences.

Le SDK est maintenant initialisé. Ajoutez-y un listener afin d'écouter les événements relatifs au statut du paiement.

Kotlin

Pour exemple, ajoutez les lignes de code qui suivent au sein de la méthode onCreate de votre activité.

 Kkiapay.get().setListener{ status, transactionId  ->
              // ecoutez la fin du paiement ( status contient les différents status possibles )
              Toast.makeText(activity, "Transaction: ${status.name} -> $transactionId", Toast.LENGTH_LONG).show()
            }

Au sein de la méthode onActivityResult de votre activité, ajoutez le handler

Kkiapay.get().handleActivityResult(requestCode, resultCode, data)

Java

Pour exemple, ajoutez les lignes de code qui suivent au sein de la méthode onCreate de votre activité.

 Kkiapay.INSTANCE.get().setListener(new Function2<STATUS, String, Unit>() {
            @Override
            public Unit invoke(STATUS status, String s) {
               // ecouter la fin du paiement ( status contient les différents status possibles )
                Toast.makeText(MA.this, "Transaction: ${status.name} -> $transactionId", Toast.LENGTH_LONG).show();
                return null;
            }
        });

Au sein de la méthode onActivityResult de votre activité, ajoutez le handler

Kkiapay.INSTANCE.get().handleActivityResult(requestCode, resultCode, data);

Une fois l’environnement prêt, déclenchez dans votre application une demande de paiement avec le code suivant :

Kotlin

    
    Kkiapay.get().requestPayment(this, "1","Paiement de services","Jhon Doe")

Java

Kkiapay.INSTANCE.get().requestPayment(this,"1","Paiement de services","Nom Prenom", "");

Les paramètres de la fonction sont :

1. Le contexte de l'activité

2. Le montant à débiter chez le client ( sans les frais )

3. Le motif (Exemple : l'objet, la description du service acheté, la désignation du produit...)

4. Le nom du client

5. Le numéro de téléphone (Optionnel)

Les différents statuts

STATUS	DESCRIPTION
SUCCESS	Le paiement a été effectué avec succès
INSUFFICIENT_FUND	Le client n'a pas suffisamment d'argent sur son compte
FAILED	Le paiement a échoué ou a été décliné par le client