Suivre un paiement

Un paiement est traité de façon asynchrone : l'API répond avant que le client n'ait payé. Deux moyens d'en connaître l'issue.

Si vous n'avez pas encore choisi votre mode de paiement, commencez par Choisir son mode de paiement.

Prérequis

• Un compte entreprise Jèko et des clés API (voir Authentification)
• Au moins un magasin (voir Gestion des magasins)
• Pour le paiement en magasin, un terminal configuré (voir Gestion des terminaux)

Le webhook, à privilégier

Configurez un endpoint webhook : Jèko l'appelle dès que la transaction se termine, sans que vous ayez à demander quoi que ce soit. C'est la seule confirmation fiable qu'un paiement a abouti.

Voir Webhooks pour la mise en place et la vérification de signature.

Interroger le statut

Vous pouvez interroger le statut d'une demande de paiement via l'API :

Pour une demande de paiement (retourne le statut) :

curl -X GET "https://api.jeko.africa/partner_api/payment_requests/{paymentRequestId}" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-KEY-ID: your_api_key_id_here"

Pour un lien de paiement (retourne canReceivePayments, pas de statut) :

curl -X GET "https://api.jeko.africa/partner_api/payment_links/{paymentLinkId}" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-KEY-ID: your_api_key_id_here"

Pour les liens à usage unique (allowMultiplePayments: false), canReceivePayments: false signifie que le paiement a eu lieu. C'est une façon de vérifier la complétion en complément des webhooks.

Étapes suivantes

• Gérer les échecs : chaque erreur renvoyée par l'API et quoi en faire
• Webhooks : recevoir et vérifier les notifications