Transferência externa TED

Uma transferência TED é muito semelhante a uma transferência Pix com conta bancária, mas usa um sistema diferente e só será processada em dias úteis até às 17:00, horário de Brasília.

Request

URL

POST 'https://apisandbox.delbank.com.br/baas/api/v2/transfers

cURL

curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/transfers' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-delbank-api-key: PJPyJ2xGmyB9oDHyNIUwNOt1dgpgolBwcE16ybaKD5rYEc8ujLtarBP0nNw2FKdgK+5YJFciFwTdORlZsdaTzjEbKN5ut+Ag4xGy69bbtXJmzkzRDHry9ubYbMW4xFMb' \
--header 'IdempotencyKey: ea2e597a-3f5f-4788-91ac-4c3b4689a868' \
--data '{
  "amount": 0.01,
  "description": "test",
  "type": "External",
  "beneficiary": {
    "participantIspb": "18236120",
    "branch": "0001",
    "holder": {
      "document": "30030030030",
      "email": "[email protected]",
      "name": "Carlos Luis"
    },
    "number": "210001953",
    "type": "CURRENT"
  }
}'

Headers

Nome	Descrição
x-delbank-api-key	Obrigatório. Chave de API
IdempotencyKey	Obrigatório. Chave idempotência da requisição. Informe um GUID, sendo um novo cada requisição.

Corpo da requisição

Name	Type	Description
amount	number	Obrigatório. Valor da transferência
description	string	Descrição sobre a transferência, somente para uso interno
type	enum	Obrigatório. Para transferência TED este valor deve ser sempre External
beneficiary	object	Obrigatório. Objeto contendo informações sobre o beneficiário da transação
participantIspb	string	Obrigatório. Código ISPB da conta bancária do cliente beneficiário.
branch	string	Obrigatório. Agência da conta beneficiária
number	string	Obrigatório. O número da conta
type	enum	Obrigatório.Tipo da conta do cliente beneficiário. Domínios: CURRENT - Conta Corrente PAYMENT - Conta Pagamento SAVING - Conta Poupança SALARY - Conta Salário
holder	object	Obrigatório. Objeto contendo informações sobre o titular da conta beneficiária
document	string	Obrigatório. CPF ou CNPJ do titular da conta beneficiária
email	string	Obrigatório. E-mail do titular da conta do beneficiário
name	string	Obrigatório. Nome completo do titular da conta do beneficiário

Resposta

O status code 200 indicará sucesso na transação.

Sendo bem-sucedido, o retorno trará os seguintes campos no formato JSON:

Note

🚧 Essas informações serão retornadas após a criação da transferência e a consulta de transferência.

{
    "id": "{id}",
    "status": "DONE",
    "type": "TED",
    "amount": 0.01,
    "createdAt": "2025-02-10T12:48:20.695Z",
    "description": "Test",
    "payer": {
        "number": "{payer_account_number}",
        "branch": "{branch}",
        "type": "{type}",
        "holder": {
            "document": "{document}",
            "name": "{name}",
            "type": "{type}"
        },
        "participant": {
            "name": "{bank}",
            "ispb": "{ispb}"
        }
    },
    "beneficiary": {
        "number": "{account_number}",
        "branch": "{branch}",
        "type": "{type}",
        "holder": {
            "document": "{document}",
            "name": "{name}",
            "type": "{type}"
        },
        "participant": {
            "name": "{bank}",
            "ispb": "{ispb}"
        }
    }
}