Para el manejo asíncrono de los resultados de pago, puedes configurar un webhook. Integrar el webhook en tu sistema te ayudará a recibir notificaciones cuando la solicitud por pinpad-payments-api reciba alguna actualización de estatus. Además, cuando se completa una transacción de pago, el sistema de Clip también envía una notificación de webhook que contiene los resultados del pago al endpoint configurado.
- Configuración:Los comerciantes deben configurar un endpoint de webhook que pueda manejar solicitudes HTTP.
- Notificación: El webhook entregará los resultados de pago a este endpoint.
- Procesamiento:Los Merchants pueden implementar lógica del lado del servidor para procesar los resultados del pago, actualizar bases de datos, activar notificaciones u realizar otras acciones necesarias.
 
Este sistema notifica los cambios de estado de sus transacciones a través de un webhook. Por favor, asegúrese de haber configurado una URL de webhook en su portal de Clip. Para obtener información detallada sobre la configuración de webhooks.
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 pinpad request. | String | pinpad-6a405173-c661-414a-9a8f-ecc77a9afe3f | UUID v4 | |
| origin | Origen del pago. | String | "pinpad-api" | "pinpad-payments-api". | |
| event_type | Estado de intención del PinPad ha cambiado. | String | "PINPAD_INTENT_STATUS_CHANGED" | Valor "UPDATE" cuando se actualiza el status de un pago. | |
Notificación de ejemplo
Ejemplo de una notificación webhook:
{
"id":"pinpad-6a405173-c661-414a-9a8f-ecc77a9afe3f"
"origin":"pinpad-payments-api"
"event_type":"PINPAD_INTENT_STATUS_CHANGED"
}Una vez obtenido ese id, puedes realizar una consulta al endpoint de Consultar un Pago para consultar la información del link de pago.
