Skip to main content
Para enviar uma TED, informe a conta, agência, banco (ISPB) e dados do titular da conta destino. Uma única chamada já executa a transferência.
A TED só é processada em dias úteis, até 17h (horário de Brasília).

Passo a passo

1

Execute a transferência

Monte o objeto beneficiary com os dados completos da conta destino e envie para POST /transfers/ted.
O status inicial é PROCESSING. Após a confirmação do SPB, o status muda para DONE. Se a TED for devolvida, o status muda para CHARGEBACKED.
O IdempotencyKey no header é obrigatório. Envie um GUID único por requisição para evitar pagamentos duplicados em caso de retry. Veja Idempotência.
A IdempotencyKey vira o id da TED. Guarde esse valor: é ele que você usa para consultar a TED.
2

Aguarde a confirmação via webhook

Quando a TED é debitada da sua conta, você recebe o evento TRANSFER_EXTERNAL_DEBITED. Veja Webhooks de transferências.Para reconciliação, consulte a TED a qualquer momento. Veja Consultar pagamento.

Headers

Campos do corpo

Envie bankAccountPayer apenas quando a conta pagadora for diferente da conta autenticada. Nesse caso, a conta autenticada precisa ser a proprietária da agência da conta pagadora e ter as permissões necessárias.
O código ISPB identifica a instituição financeira destino. Consulte a lista de participantes do SPB no Banco Central.