Webhooks de Notificación

Las transferencias hacia entidades financieras tradicionales dependen de la velocidad de compensación del banco (ACH o transferencia directa). Debido a la asincronía del proceso, Vendis enviará un evento POST a tu URL configurada cuando la transacción alcance un estado definitivo.

Suscripción a Eventos

Recomendamos suscribirte a los siguientes eventos clave para automatizar la conciliación financiera en tu base de datos:

• transfer.completed: Ocurre cuando el banco confirma que el dinero ha sido depositado con éxito en la cuenta de destino.
• transfer.failed: Ocurre cuando el banco o la red rechaza la transferencia (ej. cuenta bloqueada, CI incorrecto). Los fondos han sido devueltos a tu balance disponible.

---

Payload del Evento: Transferencia Completada

{
  "event": "transfer.completed",
  "status": "COMPLETED",
  "data": {
    "id": 123,
    "business_code": 17,
    "amount": 1500.00,
    "currency": "BOB",
    "reference": "Pago factura 001",
    "destination": {
      "type": "bank_account",
      "bank_code": 1,
      "account_number": "******-7",
      "account_titular": "Juan Pérez"
    },
    "processed_at": "2026-05-15T15:02:10Z"
  },
  "occurred_at": "2026-05-15T15:02:12Z"
}

Payload del Evento: Transferencia Fallida

En caso de fallo, el evento contendrá un objeto error brindando más contexto sobre la razón del rechazo bancario.

{
  "event": "transfer.failed",
  "status": "ERROR",
  "data": {
    "id": 123,
    "business_code": 17,
    "amount": 1500.00,
    "currency": "BOB",
    "reference": "Pago factura 001",
    "destination": {
      "type": "bank_account",
      "bank_code": 1,
      "account_number": "******-7",
      "account_titular": "Juan Pérez"
    },
    "error": {
      "code": "ACCOUNT_REJECTED",
      "message": "La cuenta de destino se encuentra inactiva o cerrada."
    },
    "processed_at": "2026-05-15T15:10:05Z"
  },
  "occurred_at": "2026-05-15T15:10:07Z"
}

Aviso de Conciliación: Al recibir transfer.failed, ten en cuenta que Vendis ya ha realizado el rollback automáticamente, liberando el held_amount y sumándolo de vuelta a tu balance.