Si se deseas contar con notificaciones webhook en tiempo real, es necesario tener un servicio para escuchar estas notificaciones Webhook.

Únicamente tienes que enviar la URL del webhook en el parámetro "webhook_url" del request del endpoint POST /checkout.

Ejemplo:

{
"webhook_url": "https://webhook.com/reception"
}

La estructura de las notificaciones webhook es la siguiente:

Parámetro	Descripción	Tipo	Ejemplo	Notas
id	id del payment request.	String	1960c5eb-d9ed-4a55-8d65-a377b5	UUID v4
origin	Origen del pago.	String	"checkout-api"	En este caso siempre se mostrará "checkout-api".
event_type	Qué tipo de acción se realizó.	String	"INSERT"	Posibles valores: "INSERT" cuando es un nuevo pago, y "UPDATE" cuando se actualiza el status de un pago.

Notificación de ejemplo

Ejemplo de una notificación webhook:

{
  "id": "1960c5eb-d9ed-4a55-8d65-a377b5",
  "origin": "checkout-api",
  "event_type": "INSERT"
}

Una vez obtenido ese id, puedes realizar una consulta al endpoint de GET/checkout/{payment_request_id}para consultar la información del link de pago.