> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Enviar (TED OUT) > Envía transferencias TED a cualquier banco brasileño con flujo de dos pasos — vista previa de tarifas, liquidación el mismo día y cumplimiento BACEN. 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](/es/reference/midaz/plugins/ted/initiate-transfer). **Endpoint:** POST /v1/transfers/initiate **Respuesta (campos clave):** ```json theme={null} { "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](/es/reference/midaz/plugins/ted/process-transfer). **Endpoint:** POST /v1/transfers/process **Respuesta (campos clave):** ```json theme={null} { "transferId": "019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d", "confirmationNumber": "20260205001", "status": "PROCESSING", "feeAmount": 1.50, "totalAmount": 1001.50 } ``` ## Cronograma de liquidación *** Los fondos se aprovisionan y la transferencia se envía a la red BACEN. La red confirma la recepción del mensaje de pago. Estado: `PROCESSING`. El banco destino confirma la liquidación. Estado: `COMPLETED`. El número de confirmación queda finalizado. 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](/es/reference/retries-idempotency) para más detalles. Para una lista completa de códigos de error, consulta la [referencia de errores TED](/es/reference/midaz/plugins/ted/ted-error-list). ## Verificar el estado de una transferencia *** Realiza un seguimiento del progreso de una transferencia en cualquier momento. **Endpoint:** [GET /v1/transfers/{transferId}](/es/reference/midaz/plugins/ted/retrieve-transfer) **Respuesta (campos clave):** ```json theme={null} { "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/{transferId}/cancel](/es/reference/midaz/plugins/ted/cancel-transfer) 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.* | Banco | ISPB | | --------------- | -------- | | Banco do Brasil | 00000000 | | Bradesco | 60746948 | | Itaú | 60701190 | | Santander | 90400888 | | Caixa Econômica | 00360305 | | Nubank | 18236120 | | Inter | 00416968 | Para una lista completa, consulta el [directorio ISPB](https://www.bcb.gov.br/pom/spb/estatistica/port/AODO.asp) en el sitio web del Banco Central.