Encaissez en ligne par Mobile Money et carte bancaire
Jèko est une plateforme de paiement pour les entreprises en Côte d'Ivoire. Cette documentation couvre son API REST : créer un paiement, être notifié du résultat, reverser des fonds.
Ils encaissent déjà avec Jèko
- TransfertCI
- AFRICAMAX
- Vague Digitale SARL
- Axelle Sanogo
- ASN Group
- Ladurée
- École Les Minimes
- Impact
- Protootype
- Ivoire Trail
Ce qui passe par Jèko
- Plus de0Md
- FCFA traités par notre infrastructure
- 0,0%
- de taux de succès sur les transactions
- 0%
- des paiements passent par Mobile Money
Jèko est pensé pour le marché ivoirien.
Encaisser tient en une seule requête
Votre serveur crée la demande et reçoit une URL. Vous y envoyez le client, il paie avec son application, et Jèko appelle votre webhook.
curl -X POST "https://api.jeko.africa/partner_api/payment_requests" \ -H "X-API-KEY: votre_cle_api" \ -H "X-API-KEY-ID: identifiant_de_la_cle" \ -H "Content-Type: application/json" \ -d '{ "storeId": "59ae202a-f583-4a15-970f-9e99bd1e0baa", "amountCents": 50000, "currency": "XOF", "reference": "commande-12345", "paymentDetails": { "type": "redirect", "data": { "paymentMethod": "wave", "successUrl": "https://boutique.ci/merci", "errorUrl": "https://boutique.ci/echec" } } }'{ "id": "d22c81f3-ee04-4ec5-8bd2-cd8af5dabcfc", "storeId": "59ae202a-f583-4a15-970f-9e99bd1e0baa", "reference": "commande-12345", "type": "redirect", "paymentMethod": "wave", "status": "pending", "redirectUrl": "https://pay.jeko.africa/pay_request/pr/d22c81f3-ee04-4ec5-8bd2-cd8af5dabcfc", "errorReason": null}Trois façons d'encaisser
Le même compte, les mêmes clés. Seule l'expérience du client change.
Paiement en ligne
Jèko Checkout
Votre serveur crée la demande et redirige le client vers son application de paiement. Vous gardez la main sur le montant, la référence et les pages de retour.
Liens de paiement
Depuis l'app, le Dashboard ou par API
Créez un lien, partagez-le par WhatsApp, SMS ou e-mail. À usage unique pour une facture, réutilisable pour une collecte.
Paiement en magasin
Jèko Box
Un QR code apparaît sur le terminal de votre point de vente, le client le scanne avec son application. Le terminal Jèko Box s'achète, 50 000 FCFA.
Nos partenaires
Vos clients paient avec ce qu'ils ont déjà. Vous n'intégrez qu'une seule API.
Ce que ça coûte
Une commission sur les transactions réussies, dans les deux sens. Rien à payer tant que rien ne passe.
Encaissement (Pay in)
L'argent entre. Commission prélevée sur les transactions réussies, jamais sur celles qui échouent.
- Jèko Checkout
- Paiement en ligne créé par API
- Liens de paiement
- Partagés par WhatsApp, SMS ou e-mail
- Jèko Box
- QR code au comptoir. Wave : 1,5 %
Reversement (Pay out)
L'argent sort, vers un compte Mobile Money ou bancaire. Crédité 24h/24 et 7j/7.
- Mobile Money
- Orange, MTN, Moov, Djamo et Wave
- Virement bancaire
- Vers un RIB, frais fixes par virement
Montants par réseau
Combien vous pouvez encaisser ou reverser en une transaction, réseau par réseau.
| Réseau | Montant minimum | Montant maximum | |
|---|---|---|---|
| À l'encaissement | Au reversement | ||
 | 5 F | 5 F | 2 000 000 F |
 | 5 F | 5 F | 2 000 000 F |
 | 100 F | 100 F | 2 000 000 F |
 | 5 F | 5 F | 2 000 000 F |
 | 5 F | 5 F | 2 000 000 F |
Explorer la documentation
Guide de démarrage
Comprendre l'écosystème, créer vos clés, faire votre premier appel.
Paiements
Choisir entre Checkout, liens de paiement et Box, puis intégrer.
Transferts
Reverser des fonds vers Mobile Money ou compte bancaire.
Webhooks
Recevoir le résultat des transactions et vérifier les signatures.
Service Providers
Intégrer vos propres marchands si vous êtes une marketplace.
Questions fréquentes
Mobile Money (Wave, Orange Money, MTN, Moov et Djamo) ainsi que les cartes bancaires. Pour un encaissement, le champ paymentMethod accepte orange, wave, mtn, moov et djamo. Les reversements acceptent en plus bank, pour un virement vers un RIB.
Appelez GET /partner_api/stores avec vos clés API : la réponse liste vos magasins avec leur storeId. Ce champ est obligatoire pour créer une demande de paiement, un lien de paiement ou un transfert. Récupérez la liste au démarrage de votre intégration plutôt que de coder les identifiants en dur. Voir la page Magasins.
Les fonds arrivent instantanément sur le compte de votre magasin, 24h/24 et 7j/7, week-ends et jours fériés compris. Vous pouvez ensuite les reverser vers un compte Mobile Money ou bancaire.
Depuis le Dashboard Business, dans Paramètres → API & Webhooks. Chaque requête porte ensuite deux en-têtes : X-API-KEY et X-API-KEY-ID.
Il n'y a pas de sandbox séparé : l'API ne publie qu'un seul serveur, en production. Pour tester, créez un magasin dédié et n'y donnez le rôle développeur qu'à votre équipe technique. Vos essais restent ainsi isolés de vos magasins réels. La marche à suivre est dans la configuration pour développeurs.
Par webhook : Jèko appelle votre endpoint dès que la transaction est terminée. Ne vous fiez pas au retour du client sur votre page de succès, il peut fermer son navigateur avant. Pour un lien de paiement, le champ canReceivePayments indique s'il accepte encore un paiement.
100 centimes (1 XOF) pour une demande de paiement, 10 000 centimes (100 XOF) pour un lien de paiement, et 500 centimes (5 XOF) pour un transfert. Tous les montants sont exprimés en centimes.
500 requêtes par minute et 1 000 par tranche de cinq minutes, appliquées par entreprise et non par clé API. Un dépassement bloque temporairement les appels pendant 10 à 15 minutes : prévoyez un backoff exponentiel.
Chaque appel est signé en HMAC-SHA256 dans l'en-tête Jeko-Signature. Vérifiez-la sur le corps brut de la requête, jamais sur le JSON reparsé, et traitez les webhooks de façon idempotente : en cas d'échec, Jèko réessaie jusqu'à trois fois.
Votre premier appel
Générez vos clés API, créez un magasin de test, et faites votre premier appel.
Commencer l'intégration