Introduction
Comment fonctionne l'écosystème Jèko : magasins, encaissements, reversements et webhooks
Jèko est une plateforme de paiement pour les entreprises en Côte d'Ivoire. Cette documentation couvre la Partner API, l'API REST qui permet d'encaisser et de reverser des fonds depuis vos propres systèmes.
Référence de l'API Jèko
Tous les endpoints, leurs paramètres et leurs réponses
L'argent circule dans deux sens
Toute l'API se résume à ces deux mouvements :
- Encaisser (pay-in) : recevoir de l'argent d'un client, par Mobile Money ou carte bancaire
- Reverser (pay-out) : envoyer de l'argent à un tiers, vers un compte Mobile Money ou bancaire
Les deux passent par le compte du même magasin. Ce que vous encaissez est donc immédiatement disponible pour être reversé, sans transfert intermédiaire.
Le magasin est l'unité de base
Une entreprise possède un ou plusieurs magasins (store) : un point de vente, une boutique en
ligne, un canal de distribution. Chaque magasin a son propre compte, son historique et son
identifiant.
Toute opération financière porte un storeId. C'est le paramètre que vous retrouverez dans
chaque appel : créer un paiement, créer un transfert, consulter un solde. Les encaissements
créditent le compte du magasin, les reversements le débitent.
Récupérez la liste de vos magasins au démarrage de votre intégration avec , et conservez les identifiants dont vous avez besoin.
Trois façons d'encaisser
| Produit | Ce que c'est | Endpoint |
|---|---|---|
| Paiement en ligne (Jèko Checkout) | Votre serveur crée la demande et redirige le client vers son moyen de paiement | |
| Liens de paiement | Un lien partageable, sans développement côté client | |
| Paiement en magasin (Jèko Box) | Un QR code s'affiche sur le terminal, le client le scanne |
Le paiement en ligne et le paiement en magasin partagent le même endpoint : seul le champ
paymentDetails.type change, redirect dans un cas, soundbox dans l'autre. Les liens de
paiement, eux, ont leur propre endpoint et leurs propres règles.
Tout est asynchrone
L'API répond immédiatement, mais le paiement n'est pas encore fait. Une demande naît avec le
statut pending : le client doit encore ouvrir son application, saisir son code et confirmer.
L'opérateur tranche ensuite, et le statut passe à success ou error.
Cette réponse immédiate est ce qui permet à votre serveur de ne pas rester bloqué pendant que le client paie.
Le webhook est la source de vérité
Quand une transaction se termine, Jèko envoie une requête POST à l'URL que vous avez configurée.
C'est la seule confirmation fiable qu'un paiement a abouti. Le retour du client sur votre page
de succès ne prouve rien : il peut fermer son navigateur avant d'y arriver, ou construire cette URL
à la main.
Ne livrez jamais une commande sur la seule foi d'une redirection. Attendez le webhook, et vérifiez sa signature.