Webhooks
Utilise les webhooks pour être informé de certains événements. Chaque webhook est signé pour garantir son authenticité. Il est possible de créer autant de points finaux de webhooks que l'on veut.
Événements possibles
order.created | (Pending) L'ordre a été créé |
order.processed | L'ordre a été traité et compensé |
order.canceled | Ordre en attente a été rejeté |
order.refunded | L'ordre a été annulé |
payment_link.created | Un nouveau lien de paiement a été créé |
payment_link.paid | Lien de paiement utilisé avec succès |
Recevoir un webhook
Nous envoyons une requête POST à l'URL définie dans le point final du webhook. Voici à quoi ressemble un exemple de corps de requête:
1 2 3 4 5 6 7 8 9 10
{ "trigger": "order.created", "created_at": "2022-02-03T02:23:47.404Z", "ident": "8ed1bae2-9ca4-4c3c-8fee-669334c783da", "signature": "a871c6067afef4cb7040c0b445f7df0503067d7af41dc95e554c47da94a553260c29051d377f5b5447f060a2d0833745177facfeb8c43daa96e9b181bc66cd88", "testing": false, "webhook_content": { "order_id": "CA-A949-E43D48E1" } }
Valider le webhook
Valide l'authenticité de l'appel du webhook à l'aide de la signature et de la clé privée. Pour cela, combine les champs trigger, ident et la clé privée en une chaîne comme dans l'exemple et crypte celle-ci avec SHA512. La chaîne cryptée obtenue doit correspondre à signature.
1 2 3 4 5 6 7
const validation = sha512(request.body.trigger + request.body.ident + your_private_key); if (request.body.signature !== validation) { return response.status(401).send() //Unauthenticated } //ToDo: implement the webhook request
Prêt à démarrer? Contacte-nous ou crée directement un compte.
Crée un compte et commence directement à calculer et à compenser les émissions de CO2 via notre API. Tu as encore des questions ou tu as besoin d'une offre personnalisée? Utilise le chat ou prends directement rendez-vous avec notre équipe de vente.