Fonctionnement de l'API
Base URL, traitement asynchrone et compte unifié : les règles communes à tous les endpoints
Cette page rassemble ce qui vaut pour tous les appels. Pour le choix d'un produit de paiement, voir Choisir son mode de paiement.
Base URL
Un seul environnement : , en production, sur des données réelles. Tous les appels passent en HTTPS.
Il n'existe pas de sandbox. Pour développer sans risque, créez un magasin dédié aux tests et n'accordez à votre équipe technique l'accès qu'à celui-ci. La marche à suivre est dans la configuration pour développeurs.
Les endpoints principaux :
- Magasins :
- Dispositifs :
- Demandes de paiement :
- Liens de paiement :
- Transferts :
Le compte unifié du magasin
Chaque magasin possède un seul compte, qui sert aux deux sens de circulation :
- Encaissements : le compte est crédité à chaque paiement réussi
- Reversements : le compte est débité à chaque transfert réussi
Il n'y a donc pas de séparation entre un compte de collecte et un compte de décaissement. Ce que vous encaissez est immédiatement disponible pour être reversé.
Pour reverser, le compte doit être provisionné au préalable. Avant chaque transfert, Jèko vérifie le solde et réserve les fonds le temps que l'opérateur confirme la remise au destinataire.
Traitement asynchrone
Toutes les transactions sont traitées de façon asynchrone. Une requête acceptée est placée en file d'attente, puis prise en charge par l'infrastructure Jèko et l'opérateur concerné.
Conséquence directe : l'API répond avant que l'opération ne soit terminée. Une demande de
paiement naît en pending et évolue vers success ou error. Votre serveur n'est jamais bloqué
pendant qu'un client saisit son code, et vous apprenez le résultat par
webhook.
Statuts
Les mêmes trois valeurs partout, paiements comme transferts :
| Statut | Signification |
|---|---|
pending | en cours de traitement, l'issue n'est pas connue |
success | opération réussie |
error | opération échouée |
Les liens de paiement font exception : ils n'ont pas de statut, mais un booléen
canReceivePayments.
Moyens de paiement
- Encaissements :
orange,wave,mtn,moov,djamo - Reversements : les mêmes, plus
bankpour un virement vers un compte bancaire (RIB)