Skip to main content

​
Overview

Le SDK de KAYBIC AFRICA permet aux développeurs et aux entreprises d’intégrer facilement des paiements Mobile Money dans leurs applications. Grâce à ces SDK, les marchands peuvent effectuer des opérations de :
  • Collecte (Cash-out) : encaisser des paiements depuis les portefeuilles Mobile Money des clients.
  • Transfert (Cash-in) : envoyer de l’argent vers un numéro Mobile Money.
  • Vérification de solde : consulter le solde du compte marchand.
  • Vérification de transaction : obtenir le statut d’une transaction.
Le SDK est disponible dans plusieurs langages afin de faciliter l’intégration dans différents environnements :
  • NodeJS
  • PHP
  • Python
  • Dart
Chaque SDK fournit une interface simple pour communiquer avec les API de paiement de KAYBIC AFRICA, tout en gérant automatiquement :
  • l’authentification
  • la signature des requêtes
  • la gestion des erreurs
  • la gestion des IPN
  • la structure des réponses

​
Fonctionnalités principales

Le SDK expose quatre fonctionnalités principales :

​
Collecte (Cash-out)

Permet de demander un paiement à un client via son compte Mobile Money. Cas d’usage :
  • paiement e-commerce
  • paiement de facture
  • paiement de service

​
Transfert (Cash-in)

Permet d’envoyer de l’argent vers un numéro Mobile Money. Cas d’usage :
  • paiement de commissions
  • remboursement client
  • paiement de partenaires

​
Vérification du solde

Permet au marchand de consulter le solde disponible sur son compte KAYBIC AFRICA.

​
Vérification d’une transaction

Permet de consulter le statut d’une transaction afin de savoir si elle est :
  • PENDING
  • SUCCESS
  • FAILED
Cette fonctionnalité est utile pour :
  • vérifier un paiement
  • synchroniser l’état d’une commande
  • gérer les callbacks ou webhooks

​
Flux de paiement typique

Un flux de paiement standard se déroule généralement comme suit :
  1. Le marchand initialise une collecte (cash-out) via le SDK.
  2. Le client reçoit une demande de confirmation Mobile Money.
  3. Le client valide la transaction sur son téléphone.
  4. Le marchand reçoit :

​
Environnements

Le SDK fonctionne pour le moment sur un seul environnement : Production
  • utilisé pour les transactions réelles
  • nécessite des clés de production (délivré par KAYBIC AFRICA)

​
Authentification

Chaque requête vers les API nécessite :
  • une API Key
  • un IPN URL
Ces informations sont fournies lors de l’inscription du marchand sur la plateforme KAYBIC AFRICA.