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.

Eventos posibles

order.created(Pendiente) Se ha creado el pedido
order.processedPedido 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 de cuerpo de 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",
    ]
  }
}

Validar gancho web

Valida la autenticidad de la llamada del webhook utilizando la firma y la clave privada. 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.

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


¬ŅTienes alguna pregunta?

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.