Webhooks — Transfer Funds to Your Bank Account

Receive real-time notifications for your SPEI transactions — whether they are successful or rejected.

Below are all the properties that may be included in the payload of a fund transfer event to your account.

Configure

Enable this event on your webhook endpoint from Configuración > Integraciones in the dashboard. See Register your endpoint in the Webhooks overview for the full registration flow and endpoint requirements.

Payload fields

Property	Type	Description
`speiDate`	String	SPEI operation date in ISO 8601 format.
`speiId`	Integer	Unique ID of the SPEI operation.
`userId`	Integer	ID of the user who executed the payout.
`userName`	String	Name of the user who executed the operation.
`amount`	Decimal	Total amount sent in the payout.
`trackingId`	String	Unique identifier generated by Billpocket to track the operation.
`status`	String	Status of the SPEI operation. Possible values: `pagado` (the payout was successful) or `rechazado` (there was an error in the payout).
`failedReason`	String, null	If an error occurred, the reason for the failure.
`failedReasonCode`	String, null	If an error occurred, the error code associated with the failure.

The payload is a single JSON object — one notification per SPEI operation.

Examples

Successful transfer

{
  "speiDate": "2025-04-10T10:00:16.000Z",
  "speiId": 49540693,
  "userId": 61918,
  "userName": "JUAN GARCÍA",
  "amount": 38.86,
  "trackingId": "BILLPOCKET06191849540693",
  "status": "pagado",
  "failedReason": null,
  "failedReasonCode": null
}

Failed transfer

When the payout is rejected, status is rechazado and both failedReason and failedReasonCode are populated.

{
  "speiDate": "2025-04-10T10:00:16.000Z",
  "speiId": 49540694,
  "userId": 61918,
  "userName": "JUAN GARCÍA",
  "amount": 38.86,
  "trackingId": "BILLPOCKET06191849540694",
  "status": "rechazado",
  "failedReason": "DISPERSION DECLINADA",
  "failedReasonCode": "9999"
}

Error codes

Check the full list of possible SPEI rejection codes in Transfer funds to your bank account errors.

Got a suggestion on this documentation? Contact us.

Webhooks — Transfer Funds to Your Bank Account

Configure#

Payload fields#

Examples#

Successful transfer#