Webhooks

Utiliza webhooks para recibir notificaciones sobre determinados eventos. Cada webhook está firmado para garantizar su autenticidad. Se puede crear cualquier número de puntos finales de webhook.

Posibles acontecimientos

order.created(Pendiente) Se ha creado la Orden
order.processedEl pedido fue procesado y compensado
order.canceledPedido pendiente cancelado
order.refundedPedido cancelado
payment_link.createdSe ha creado un nuevo enlace de pago
payment_link.paidEnlace de pago utilizado correctamente

Recibir webhook

Enviamos una solicitud POST a la URL definida en el punto final del webhook. Este es un ejemplo del cuerpo de una solicitud:

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",
    ]
  }
}

Validación de webhooks

Valida la autenticidad de la llamada al webhook utilizando la firma y la clave privada. Para ello, combina los campos desencadenante, identidad y la clave privada en una cadena como en el ejemplo y cífrala con SHA512. La cadena cifrada resultante debe coincidir con firma.

Recuperar la clave privada 
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

Recursos relacionados

API

Enlaces de pago

Precios

¿Todavía tiene preguntas?

Chatea con nosotros
Planificar una reunión

No necesitas tarjeta de crédito: crea una cuenta ahora

Crea una cuenta y empieza a calcular y compensar las emisiones de CO2 directamente a través de nuestra API. ¿Todavía tienes preguntas o necesitas un presupuesto personalizado? Utiliza el chat o concierta una cita directamente con nuestro equipo de ventas.

Crea una cuenta ahora
Chatea con nosotros
Planificar una reunión
Precios