Choisir son mode de paiement
Quel produit Jèko pour quel cas d'usage : paiement en ligne, lien de paiement ou terminal en magasin
Jèko propose trois façons d'encaisser. Cette page vous aide à choisir avant d'écrire du code.
Cas d'usage fréquents
| Votre situation | Produit recommandé |
|---|---|
| Site e-commerce, tunnel de commande sur votre site | Paiement en ligne |
| Application mobile qui encaisse ses utilisateurs | Paiement en ligne |
| Facture à envoyer par WhatsApp, SMS ou e-mail | Liens de paiement |
| Collecte de fonds, dons, page de paiement réutilisable | Liens de paiement |
| Boutique, restaurant, encaissement au comptoir | Paiement en magasin |
| Vous n'avez pas d'équipe technique disponible | Liens de paiement |
Les trois produits en détail
Paiement en ligne (Jèko Checkout)
Votre serveur crée une demande de paiement, reçoit une URL, et y redirige le client. Celui-ci paie avec son application Mobile Money, puis revient sur l'URL de votre choix.
C'est le mode qui vous donne le plus de contrôle : vous décidez du moment, du montant, de la référence, et des pages de retour. C'est aussi celui qui demande un serveur capable d'appeler l'API et de recevoir un webhook.
POST /partner_api/payment_requestsChamp déterminant : paymentDetails.type: "redirect", avec successUrl et errorUrl obligatoires.
La réponse contient un redirectUrl vers lequel envoyer le client.
Liens de paiement
Vous créez un lien, vous le partagez. Le client l'ouvre, paie, c'est terminé. Aucun développement côté client, aucune page à héberger.
Un lien peut être à usage unique (il se ferme après le premier paiement réussi) ou réutilisable, pour une collecte ou des dons.
POST /partner_api/payment_linksLe champ title est obligatoire (10 à 255 caractères), et le montant minimum est de 10 000 centimes,
soit 100 XOF. La réponse contient le champ link, l'URL à partager.
Paiement en magasin (Jèko Box)
Un QR code apparaît sur le terminal Jèko de votre point de vente. Le client le scanne avec son application et confirme.
POST /partner_api/payment_requestsMême endpoint que le paiement en ligne, mais avec paymentDetails.type: "soundbox" et le
deviceId du terminal concerné, que vous obtenez via .
Ce qui est commun aux trois
Le magasin. Chaque paiement porte un storeId et crédite le compte de ce magasin.
Les montants en centimes. amountCents: 50000 vaut 500 XOF. Le minimum est de 100 centimes pour
une demande de paiement, 10 000 pour un lien. Le montant doit être un multiple de 100 : le franc
CFA n'a pas de subdivision, et 12345 est rejeté en 422.
Les moyens de paiement. paymentMethod accepte orange, wave, mtn, moov et djamo.
Le traitement asynchrone. L'API répond avant que le client n'ait payé. Le résultat arrive ensuite, par webhook.
Suivre le résultat
C'est la différence la plus importante entre les produits :
- Une demande de paiement possède un
status:pending, puissuccessouerror. Vous pouvez l'interroger à tout moment. - Un lien de paiement n'a pas de statut. Son champ booléen
canReceivePaymentsindique seulement s'il accepte encore un paiement.
Dans les deux cas, la confirmation fiable est le webhook.