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.

CommencerRéférence API

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.

POSTapi.jeko.africa/partner_api/payment_requests
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"      }    }  }'
Réponseen attente
{  "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}
La réponse s'affichera ici

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.

  • Orange Money
  • MTN Mobile Money
  • Moov Money
  • Djamo
  • Wave
  • Visa
  • Mastercard
  • GIM-UEMOA

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.

Encaissements : 1,5 % par transaction Mobile Money.

Reversements : 1,5 % vers un compte Mobile Money, 1 000 FCFA fixes vers un compte bancaire.

Aucun abonnement, aucun frais d'activation, et l'intégration est gratuite. Vous ne payez que sur les transactions réussies.

Les tarifs à jour, remises au volume comprises, sont sur jeko.africa/pricing.

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