Consultar Transferencias

Una vez creada una transferencia mediante un POST inicial asíncrono, puedes hacer polling o consultar el estado de la misma utilizando su identificador. Sin embargo, para integraciones robustas, recomendamos usar la suscripción a Webhooks.

Consultar una Transferencia Específica

• Endpoint: /api/v2/transfers/{transfer_id}
• Método: GET

Ejemplo de Respuesta (HTTP 200 OK)

{
  "id": 123,
  "business_code": 17,
  "status": "IN_TRANSIT",
  "amount": 1500.0,
  "currency": "BOB",
  "reference": "Pago factura 001",
  "destination": {
    "type": "bank_account",
    "bank_code": 1,
    "account_number": "******-7",
    "account_titular": "Juan Pérez"
  },
  "created_at": "2026-05-15T15:00:00Z",
  "processed_at": null,
  "error": null
}

Tabla de Estados de una Transferencia (status)

Estado	Significado (Comportamiento Interno)
PENDING	Solicitud recibida. Los fondos están retenidos del saldo de la cuenta.
IN_TRANSIT	Procesando internamente con la entidad financiera.
COMPLETED	Éxito (Final). El dinero se ha depositado exitosamente en la cuenta destino.
ERROR	Fallido (Final). La transferencia fue rechazada. El dinero retenido se libera y regresa al saldo disponible del cliente de inmediato.