Crochets Web

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 tu le souhaites.

Événements possibles

order.createdL'ordre (en attente) a été créé
order.processedLa commande a été traitée et compensée
order.canceledL'ordre 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
11
12
{
  "trigger": "order.created",
  "created_at": "2022-02-03T02:23:47.404Z",
  "ident": "8ed1bae2-9ca4-4c3c-8fee-669334c783da",
  "signature": "a871c6067afef4cb7040c0b445f7df0503067d7af41dc95e554c47da94a553260c29051d377f5b5447f060a2d0833745177facfeb8c43daa96e9b181bc66cd88",
  "testing": false,
  "webhook_content": {
    "order_ids": [
      "CA-A949-E43D48E1",
    ]
  }
}

Validation des webhooks

Valide l'authenticité de l'appel 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.

Récupérer la clé privée 
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

Ressources connexes

API

Liens de paiement

Fixation des prix

Tu as encore des questions ?

Chatte avec nous
Planifie une réunion

Pas besoin de carte de crédit - Crée un compte maintenant

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.

Créer un compte maintenant
Chatte avec nous
Planifie une réunion
Fixation des prix