Webhook de notificación
Usted puede implementar un servicio para recibir y procesar notificaciones relacionadas con los estados finales del Payout desde Bamboo.
El API de Payouts solo envía notificaciones para los siguientes estados (held, pagado, declinado y rechazado). Para los estados de los Payouts, revise nuestro artículo de estados.
| ESTADO | Código | DESCRIPCIÓN |
|---|---|---|
Held | 7 | El payout está en revisión por nuestro Equipo de Cumplimiento. |
Paid | 1 | El payout ha sido realizado. Este es un estado final que indica la conclusión exitosa del pago. |
Declined | 8 | El payout fue declinado debido a validación estructural o reglas de Compliance. |
Rejected | 4 | El payout fue rechazado. Las posibles razones de rechazo incluyen problemas con la cuenta bancaria, límites mensuales excedidos, etc. |
El comercio debe publicar un servicio HTTP/REST al cual se enviarán las notificaciones generadas.
Especificaciones del servicio WebHook
El servicio WebHook es un servicio REST que debe procesar una solicitud con las siguientes características:
| URL: | <Determinado por el comercio> |
| API Type: | Pública |
| Method: | POST |
| Response: | Código HTTP |
Parámetros de la notificación
| Parámetro | Formato | Description |
|---|---|---|
payoutId | integer | Identificador interno del Payout. |
reference | string | Identificador único del Payout definido por usted cuando solicitó el Payout. |
isoCountry | string | Código ISO del país en formato ISO 3166-2. |
created | date | Fecha y hora de la solicitud del Payout. |
lastUpdate | date | Fecha y hora de la última actualización del Payout. |
status | integer | Código interno del estado actual del Payout. |
statusDescription | string | Estado actual del Payout. Consulte este artículo para aprender más acerca de los estados de los Payouts. |
errorCode | string | Código interno del error del Payout declinado. Encuentre los posibles errores aquí. |
errorDescription | string | Descripción del error del Payout declinado. |
amount | object | Valor y moneda solicitado en el Payout. |
localAmount | object | Valor y moneda solicitado en el Payout en moneda local. |
exchangeRate | numeric | Valor de conversión utilizado en el Payout. |
payee | object | Información del beneficiario del Payout. |
description | string | La descripción / razón ingresada en el request. |
Ejemplo de la notificación
{
"payoutId": 204307526961955232,
"reference": "ARI-904",
"isoCountry": "BG",
"created": "2025-07-17T18:45:12.4807443Z",
"lastUpdate": "2025-07-17T18:45:12.4808228Z",
"status": 8,
"statusDescription": "Declined",
"errorCode": "813",
"errorDescription": "Declined by validation for account",
"amount": {
"value": 5.08,
"isoCurrency": "USD"
},
"localAmount": null,
"exchangeRate": null,
"payee": {
"firstName": "Ari",
"lastName": "Carba",
"email": "",
"phone": "099999999",
"location": {
"city": "city",
"address": "address",
"zipCode": "zip"
},
"document": {
"number": "ABC123456789",
"type": "BULSTAT"
}
},
"description": "string"
} Estado: Held
{
"payoutId": 204307526961955232,
"reference": "ARI-904",
"isoCountry": "BG",
"created": "2025-07-17T18:45:12.4807443Z",
"lastUpdate": "2025-07-17T18:45:12.4808228Z",
"status": 7,
"statusDescription": "Held",
"errorCode": "null",
"errorDescription": "null",
"amount": {
"value": 5.08,
"isoCurrency": "USD"
},
"localAmount": null,
"exchangeRate": null,
"payee": {
"firstName": "Ari",
"lastName": "Carba",
"email": "",
"phone": "099999999",
"location": {
"city": "city",
"address": "address",
"zipCode": "zip"
},
"document": {
"number": "ABC123456789",
"type": "BULSTAT"
}
},
"description": "string"
} Info
En notificaciones de payout para persona jurídica, se recibirá el campo companyName en lugar de firstName y lastName.
