Saltar al contenido principal
TED OUT permite a tus 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 tu 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. Consulta 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ía el initiationId para procesar la transferencia. Los fondos se aprovisionan y el pago se envía a la red BACEN. La mayoría de las integraciones procesan la transferencia solo con initiationId. Los tenants que firman payloads TED OUT fuera del plugin primero llaman a POST /v1/transfers/signing/prepare y luego envían signingArtifactId, payloadHash y signature junto con el mismo initiationId. Consulta 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 tu 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 tu 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.rejected.
El plugin reintenta automáticamente (hasta tres intentos por defecto). Si el resultado sigue siendo desconocido después de los reintentos — un 5xx o timeout de JD SPB — la transferencia no se revierte automáticamente: la retención se preserva y la transferencia se entrega al worker de reconciliación, que la resuelve contra el libro mayor. Si la reconciliación se agota, la transferencia se marca para revisión manual del operador (MANUAL_REVIEW). Los fondos nunca se pierden, pero la resolución puede no ser inmediata. (Un rechazo 4xx claro es diferente — revierte la retención de inmediato; consulta el caso “rechazada por el banco destino” más arriba.)
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 tu 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. Usa este encabezado al reintentar solicitudes para evitar envíos duplicados. Consulta Reintentos e idempotencia para más detalles.
Para una lista completa de códigos de error, consulta la referencia de errores TED.

​
Verificar el estado de una transferencia

Realiza 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",
  "senderAccountId": "019c96a0-a910-7abc-d1e2-8c9d0e1f2a3b",
  "recipientAccountId": null,
  "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, consulta el directorio ISPB en el sitio web del Banco Central.