Webhook de notificación
Un webhook es una URL que configuras en tu aplicación para recibir notificaciones cuando ocurre un evento relacionado con tus links de pago, como la confirmación exitosa o el fallo de la transacción.
Configuración del Webhook
Ingresa a Cubo Admin
Dirígete a la sección Developers
Da clic sobre el recuadro donde se muestra la información de tu API Key.
(Si aún no tienes tu API Key, revisa nuestra sección de autenticación).
Se mostrará una ventana emergente, donde debes seleccionar la opción “Agregar Webhook”.
Agrega tu Webhook
Ingresa la URL donde deseas recibir la información del pago y da clic en “Confirmar”.
Payload
A continuación se detalla el payload que recibirás en el webhook. Este incluye los campos y datos relevantes que tu aplicación deberá procesar. Cada campo se describe con su nombre, tipo de dato y una breve explicación de su función para facilitar la integración.
| Parámetro | Tipo | Descripción |
|---|---|---|
identifier | string | Identificador único del pago. |
status | string | Estado del pago. Puede ser SUCCEEDED o REJECTED. |
referenceId | string | Referencia única de la transacción. |
authorizationCode | string | Código de autorización del pago. |
processedAt | string | Fecha y hora del procesamiento en formato ISO 8601. |
paymentType | string | Tipo de pago realizado. |
amount | number | Monto total del pago en centavos. |
metadata | object | Información adicional opcional proporcionada en la transacción. |
Este es un ejemplo de cómo se vería la información en formato JSON, reflejando los datos clave de la transacción:
{
"identifier": "RHBKY73PZ",
"status": "SUCCEEDED",
"referenceId": "355069574072669",
"authorizationCode": "007194",
"processedAt": "2025-03-10T09:56:47.228Z",
"paymentType": "LINK-SUBSCRIPTION",
"amount": 1000,
"metadata": null
}