Webhooks — Transferencia de fondos a tu cuenta bancaria

Recibe notificaciones en tiempo real de tus transacciones SPEI, tanto exitosas como rechazadas.

A continuación tienes todas las propiedades que puede incluir el payload de un evento de transferencia de fondos a tu cuenta.

Configuración

Habilita este evento en tu endpoint de webhook desde Configuración > Integraciones en el dashboard. Consulta Registra tu endpoint en la vista general de Webhooks para conocer el flujo de registro completo y los requisitos del endpoint.

Campos del payload

Propiedad	Tipo	Descripción
`speiDate`	String	Fecha de la operación SPEI en formato ISO 8601.
`speiId`	Integer	ID único de la operación SPEI.
`userId`	Integer	ID del usuario que ejecutó la dispersión.
`userName`	String	Nombre del usuario que ejecutó la operación.
`amount`	Decimal	Monto total enviado en la dispersión.
`trackingId`	String	Identificador único generado por Billpocket para rastrear la operación.
`status`	String	Estado de la operación SPEI. Valores posibles: `pagado` (la dispersión fue exitosa) o `rechazado` (hubo un error en la dispersión).
`failedReason`	String, null	Si ocurrió un error, el motivo del fallo.
`failedReasonCode`	String, null	Si ocurrió un error, el código de error asociado al fallo.

El payload es un solo objeto JSON: una notificación por cada operación SPEI.

Ejemplos

Transferencia exitosa

{
  "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
}

Transferencia fallida

Cuando la dispersión se rechaza, status es rechazado y tanto failedReason como failedReasonCode traen valor.

{
  "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"
}

Códigos de error

Consulta la lista completa de códigos de rechazo de SPEI en Errores de transferencia de fondos.

¿Tienes una sugerencia sobre esta documentación? Escríbenos.

Webhooks — Transferencia de fondos a tu cuenta bancaria

Configuración#

Campos del payload#

Ejemplos#

Transferencia exitosa#