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.processedL'ordre a été traité et compensé
order.canceledOrdre en attente a été rejeté
order.refundedL'ordre a été annulé
payment_link.createdUn nouveau lien de paiement a été créé
payment_link.paidLien 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.