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.1.8'

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
Java
MyApplication.kt
Kkiapay.init(applicationContext,"<votre-kkiapay-api-key>",
SdkConfig(themeColor = R.color.colorPrimary,
imageResource = R.raw.votre_logo))

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

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

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
Java

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)

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
Java
Kkiapay.get().requestPayment(this, "1","Paiement de services","Jhon Doe")
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 à échoué ou a été décliné par le client