Webhooks — Transfer Funds (v1)
Billpocket sends a webhook notification when funds are transferred to your registered CLABE account. This is the v1 format, which delivers events as an array of transfer objects.
Event type#
Webhook payload#
The v1 payload is an array of transfer objects.[
{
"userId": 12345,
"amount": 1500.00,
"status": "success",
"clabe": "012345678900000001",
"date": "2024-06-13T10:00:00.000Z",
"reference": "REF001",
"concept": "Dispersión de fondos"
}
]
Fields#
| Field | Type | Description |
|---|
userId | integer | Billpocket user ID |
amount | decimal | Amount transferred in MXN |
status | string | "success" or "failed" |
clabe | string | Destination CLABE account |
date | string | Transfer date (ISO 8601) |
reference | string | Transfer reference |
concept | string | Transfer concept |
Failed transfer#
When a transfer fails, the status is "failed" and a failedReasonCode and failedReason are included:[
{
"userId": 12345,
"amount": 500.00,
"status": "failed",
"clabe": "012345678900000001",
"date": "2024-06-13T10:00:00.000Z",
"reference": "REF002",
"concept": "Dispersión de fondos",
"failedReasonCode": "0011",
"failedReason": "CUENTA INEXISTENTE"
}
]
Next steps#
Got a suggestion on this documentation? Contact us.
Modified at 2026-07-09 22:28:10