Introduction aux Webhooks
Comprendre les notifications webhook et leur intégration dans l'API Jèko
Vue d'ensemble
Jèko appelle votre endpoint dès qu'une transaction se termine, avec le résultat. Vous n'avez donc pas à interroger l'API en boucle pour savoir où en est un paiement, ce qui vous ferait de toute façon atteindre la limite de 500 requêtes par minute.
Chaque appel est signé en HMAC-SHA256, et réessayé jusqu'à trois fois si votre serveur ne répond pas.
Quand le webhook est envoyé
Jèko envoie un seul webhook, à la fin du traitement d'une transaction. Son corps est la transaction elle-même, sans enveloppe : le champ status indique l'issue.
Il est envoyé pour :
- Les paiements complétés (via demandes de paiement ou liens de paiement)
- Les transferts complétés ou échoués
Un paiement qui échoue ne déclenche aucun webhook. Pour détecter un échec, interrogez depuis votre page de retour, ou lorsque le client revient sans que vous ayez reçu de notification. Ne comptez pas sur l'absence de webhook pour conclure à un succès.
Flux de webhook
- Configuration : Configurez votre URL de webhook dans le Dashboard Business
- Événement : Un événement se produit (paiement complété, transfert effectué, etc.)
- Notification : Jèko envoie une requête POST à votre endpoint
- Vérification : Vous vérifiez la signature pour authentifier la requête
- Traitement : Vous traitez l'événement dans votre application
- Réponse : Vous retournez un code de statut HTTP 200 pour confirmer la réception
Étapes suivantes
- Intégration : Guide complet pour intégrer les webhooks
- Comportement des webhooks : Comprendre le comportement et les retries
- Bonnes pratiques : Sécurité, idempotence et monitoring
- Exemples de code : Exemples d'implémentation dans différents langages