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.