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 Les trois produits.

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