Quand un paiement se complète sur 0fee.dev -- que ce soit via la page de checkout de Stripe, le push USSD de Hub2 ou le flux de redirection de PaiementPro -- le marchand doit être informé. Il ne peut pas interroger l'API en continu. La solution, ce sont les webhooks : des requêtes HTTP POST envoyées de 0fee.dev vers le serveur du marchand chaque fois qu'un événement de paiement se produit. Mais la livraison de webhooks est plus difficile qu'il n'y paraît. Les serveurs des marchands tombent en panne. Les réseaux échouent. Les pare-feu bloquent les requêtes. Le système de webhooks doit gérer tout cela de manière fiable.
Signature HMAC-SHA256
Chaque livraison de webhook inclut une signature HMAC-SHA256 dans l'en-tête X-ZeroFee-Signature. Le marchand peut vérifier que le webhook provient bien de 0fee.dev et n'a pas été modifié en transit.
Retries avec backoff exponentiel
Quand une livraison échoue, le système programme des retentatives avec des délais croissants : 1 minute, 5 minutes, 30 minutes, 2 heures, 8 heures, 24 heures. Après 6 tentatives infructueuses, le webhook est marqué comme échoué et l'endpoint est candidat à la désactivation automatique.
Désactivation automatique
Si un endpoint de webhook échoue 10 fois consécutives sur différents événements, 0fee.dev désactive automatiquement cet endpoint et notifie le marchand par e-mail. Cela évite de gaspiller des ressources sur des endpoints qui ne répondent plus.
Types d'événements
payment.created
payment.completed
payment.failed
payment.expired
payment.cancelled
refund.created
refund.completed
refund.failed
checkout.completed
checkout.expiredJournal de livraison
Chaque tentative de livraison est enregistrée avec le code de réponse, le temps de réponse et le corps de la réponse. Les marchands peuvent consulter ce journal dans le tableau de bord pour déboguer les problèmes d'intégration.
Cet article fait partie de la série « Comment nous avons construit 0fee.dev ». 0fee.dev est un orchestrateur de paiement couvrant 53+ fournisseurs dans 200+ pays, construit par Juste Thales Gnimavo et Claude depuis Abidjan sans aucun ingénieur humain. Suivez la série pour l'histoire complète de la construction.