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
Java
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.
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
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)
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 |
| |