Saltar al contenido principal
TED OUT permite a sus clientes enviar dinero a cualquier cuenta de cualquier banco brasileño. El flujo de dos pasos — iniciar y luego confirmar — le da al cliente la oportunidad de revisar la tarifa antes de comprometer la transferencia. La liquidación es el mismo día (D+0) para transferencias confirmadas antes de las 17:00 hora de Brasilia.

​
Cómo funciona para su cliente

Paso 1 — Ingresar los datos y revisar la tarifa El cliente proporciona los datos bancarios del destinatario y el monto. El sistema calcula la tarifa y devuelve el costo total antes de que se debite cualquier cosa. El cliente ve exactamente lo que pagará. Paso 2 — Confirmar y enviar Una vez que el cliente confirma, los fondos (monto + tarifa) se debitan de su cuenta y la transferencia se envía a la red BACEN. Se emite un número de confirmación de inmediato.

​
Requisitos previos

Antes de que se pueda iniciar una transferencia:
  • El remitente debe tener una cuenta registrada en CRM
  • El saldo del remitente debe cubrir el monto de la transferencia más la tarifa aplicable
  • La transferencia debe solicitarse en un día hábil entre las 06:30 y las 17:00 (hora de Brasilia)

​
Paso 1: Iniciar la transferencia

El cliente envía los datos del destinatario y el monto. El sistema valida la solicitud, calcula la tarifa y crea una intención de transferencia válida por 24 horas. En esta etapa no se mueven fondos. Consulte la especificación completa de la solicitud en la referencia Initiate Transfer. Endpoint: POST /v1/transfers/initiate Respuesta (campos clave): 
{
  "initiationId": "019c96a0-aa10-7abc-d1e2-8c9d0e1f2a3b",
  "feeAmount": 1.50,
  "totalAmount": 1001.50,
  "status": "PENDING_CONFIRMATION",
  "expiresAt": "2026-02-06T15:30:00-03:00"
}
Dirección de la tarifa (cash-out): Para transferencias TED OUT y P2P, la tarifa se suma al monto de la transferencia: totalAmount = amount + feeAmount. La cuenta del remitente se debita por el total completo. Esto es lo opuesto a TED IN, donde la tarifa se deduce del monto recibido.
La intención de transferencia vence 24 horas después de la iniciación. Si el cliente no confirma dentro de esa ventana, se debe crear una nueva iniciación.

​
Paso 2: Confirmar la transferencia

Una vez que el cliente revisa la tarifa y confirma, envíe el initiationId para procesar la transferencia. Los fondos se aprovisionan y el pago se envía a la red BACEN. Consulte la especificación completa de la solicitud en la referencia Process Transfer. Endpoint: POST /v1/transfers/process Respuesta (campos clave): 
{
  "transferId": "019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d",
  "confirmationNumber": "20260205001",
  "status": "PROCESSING",
  "feeAmount": 1.50,
  "totalAmount": 1001.50
}

​
Cronograma de liquidación

1

Confirmada (T+0s)

Los fondos se aprovisionan y la transferencia se envía a la red BACEN.
2

Reconocida (T+2s)

La red confirma la recepción del mensaje de pago. Estado: PROCESSING.
3

Liquidada (T+90s típico)

El banco destino confirma la liquidación. Estado: COMPLETED. El número de confirmación queda finalizado.
4

Cliente notificado (T+95s)

Se envía un evento webhook transfer.completed a su sistema.
SLA: Menos de 10 minutos de forma típica. Liquidación el mismo día (D+0) para transferencias confirmadas antes de las 17:00 hora de Brasilia.

​
Horario de operación

TED opera de lunes a viernes, 06:30–17:00 (Brasilia, UTC-3). Las transferencias solicitadas fuera de esta ventana se rechazan de inmediato — no se mueven fondos. La respuesta de error incluye el próximo horario disponible.

​
Manejo de errores

Cuando algo sale mal, el dinero de su cliente siempre está contabilizado:
La institución receptora rechaza la transferencia. Los fondos aprovisionados se liberan de inmediato y el monto completo (incluyendo la tarifa) se devuelve al saldo del remitente. Estado: REJECTED. Se envía un webhook transfer.failed.
El plugin reintenta automáticamente hasta cinco veces. Si la transferencia no puede confirmarse después de los reintentos, se emite un reembolso de seguridad y se restaura el saldo del remitente. No se requiere acción manual.
Si el banco destino devuelve los fondos después de la liquidación inicial (por ejemplo, cierre de cuenta o retención regulatoria), el monto se revierte en su libro mayor como una transacción separada. Esto se maneja fuera del ciclo de vida de la transferencia — el registro original permanece COMPLETED y se crea un nuevo registro de contracargo.
Los endpoints de transferencia admiten idempotencia mediante el encabezado de solicitud X-Idempotency. Use este encabezado al reintentar solicitudes para evitar envíos duplicados. Consulte Reintentos e idempotencia para más detalles.
Para una lista completa de códigos de error, consulte la referencia de errores TED.

​
Verificar el estado de una transferencia

Realice un seguimiento del progreso de una transferencia en cualquier momento. Endpoint: GET /v1/transfers/ Respuesta (campos clave): 
{
  "transferId": "019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d",
  "confirmationNumber": "20260205001",
  "type": "TED_OUT",
  "status": "COMPLETED",
  "amount": 1000.00,
  "feeAmount": 1.50,
  "totalAmount": 1001.50,
  "createdAt": "2026-02-05T15:30:00-03:00",
  "completedAt": "2026-02-05T15:35:12-03:00"
}

​
Cancelar una transferencia

Una transferencia puede cancelarse mientras esté en estado CREATED o PENDING — antes de que haya sido enviada a la red. Endpoint: POST /v1/transfers//cancel
Las transferencias en estado PROCESSING o estados posteriores no pueden cancelarse. Una vez enviada a la red BACEN, la transferencia debe completarse o fallar antes de que sea posible cualquier reversión.

​
Códigos ISPB comunes

Última verificación: 2026-02-06. Los valores están sujetos a cambios.
BancoISPB
Banco do Brasil00000000
Bradesco60746948
Itaú60701190
Santander90400888
Caixa Econômica00360305
Nubank18236120
Inter00416968
Para una lista completa, consulte el directorio ISPB en el sitio web del Banco Central.