Vue d’ensemble
Les webhooks JEKO permettent de recevoir des notifications en temps réel lorsque des événements se produisent dans votre compte. Au lieu de poller l’API pour vérifier les statuts, vous pouvez configurer un endpoint qui recevra automatiquement les notifications.Avantages des webhooks
- Temps réel : Recevez des notifications instantanément lorsque des événements se produisent
- Efficacité : Pas besoin de poller l’API régulièrement
- Fiabilité : Système de retry automatique en cas d’échec
- Sécurité : Authentification via signature HMAC-SHA256
Type d’événement
JEKO envoie un seul type de webhook, portant l’état d’une transaction. Le webhook est envoyé pour :- Les paiements (via demandes de paiement ou liens de paiement)
- Les transferts
status, à la racine du payload, indique l’état : success, error ou pending.
Le payload est plat — les champs sont à la racine, sans enveloppe
event / data — et la référence n’est pas à la racine. Voir Retrouver votre référence.Flux de webhook
- Configuration : Configurez votre URL de webhook dans le Jeko Cockpit
- Événement : Un événement se produit (paiement complété, transfert effectué, etc.)
- Notification : JEKO 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 : Recommandations pour une intégration robuste
- Exemples de code : Exemples d’implémentation dans différents langages