CinetPay SDK-ANDROID integration


Ce package vous permet d'invoquer le guichet de paiement de CinetPay, effectuer un paiement et attendre le statut du paiement initié à la seconde près après la fin du paiement

🔗 Les étapes

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
  • Les données relatives au paiement

🛠 Installation

Debutez l'installation en clonant CinetPay Android SDK sur Github

  • Ajoutez com.cinetpay:androidsdk à vos dépendances build.gradle
    dependencies {
    implementation 'com.cinetpay:androidsdk:1.0.0'
    }

Initialisation du guichet

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

  • apikey | L’identifiant du marchand | Chaine de caractère | Obligatoire
  • site_id | L'identifiant du service | Entier | Obligatoire
  • notify_url | URL de notification de paiement valide | URL | Obligatoire

Données de paiement

Pour effectuer le paiement, certaines données devront-être soumises pour préparer le guichet. Ainsi, on a :

  • amount | Montant du paiement (>= 100 XOF) | Entier | Obligatoire
  • currency | Devise du paiement (XOF - XAF - CDN - GNF - USD) | Chaîne de caractère | Obligatoire
  • transaction_id | L'identifiant de la transaction. Elle doit-être unique, pour chaque transaction | Chaîne de caractère | Obligatoire
  • description | La description de votre paiement | Chaîne de caractère | Obligatoire
  • channels | L’univers de paiement. Peut être : ALL - MOBILE_MONEY - CREDIT_CARD - WALLET. Par défaut : 'ALL' Toute combinaison est applicable à en séparant par une virgule : 'MOBILE_MONEY, WALLET' | Chaîne de caractère | Facultatif
  • metadata | | Chaîne de caractère | Facultatif
  • customer_name | Nom de l’acheteur * | Chaîne de caractère | Facultatif
  • customer_surname | Prénoms de l’acheteur * | Chaîne de caractère | Facultatif
  • customer_email | Adresse email de l’acheteur * | Chaîne de caractère | Facultatif
  • customer_phone_number | Numéro de téléphone de l’acheteur * | Chaîne de caractère
  • customer_city | Ville de l’acheteur * | Chaîne de caractère | Facultatif
  • customer_country | Pays de l’acheteur. Code ISO2 du pays (CI => Côte-d'Ivoire). * | Chaîne de caractère | Facultatif
  • customer_state | Etat de l’acheteur (Lorsque USA est utilisé comme pays) * | Chaîne de caractère | Facultatif
  • customer_zip_code | Code postal de l’acheteur * | Chaîne de caractère | Facultatif

    NB : * Obligatoire si utilisation de l’univers bancaire (CREDIT_CARD)

Utilisation du package

Pour initier un paiement ajouter vos identifiants dans le fichier: app/src/main/java/com/cinetpay/androidsdk/sample/activities/MainActivity.java

    String api_key = ""; // TODO A remplacer par votre clé API
    String site_id = ""; // TODO A remplacer par votre Site ID

Gestion des réponses

Les différents réponses des requêtes(succès ou erreur) sont inscrit dans le log : app/src/main/java/com/cinetpay/androidsdk/sample/MyCinetPayWebAppInterface.java

    @Override
    @JavascriptInterface
    public void onResponse(String response) {
        Log.d("MyCinetPayWebApp", response);
    }

    @Override
    @JavascriptInterface
    public void onError(String response) {
        Log.d("MyCinetPayWebApp", response);
    }
android