API Reference
Log In
API Reference

Transferência entre contas Delbank

Transferência entre contas

Para realizar uma transferência para uma conta Delbank, basta informar o número da conta beneficiária.

Requisição

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

curl --location 'https://apisandbox.delbank.com.br/baas/api/v2/transfers' \
--header 'IdempotencyKey: d52b1763-1038-4606-b84b-e56c098b064f' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-delbank-api-key: PJPyJ2xGmyB9oDHyNIUwNOt1dgpgolBwcE16ybaKD5rYEc8ujLtarBP0nNw2FKdgK+5YJFciFwTdORlZsdaTzjEbKN5ut+Ag4xGy69bbtXJmzkzRDHry9ubYbMW4xFMb' \
--data '
{
  "amount": 0.01,
  "beneficiaryAccount": "10073",
  "description": "testing"
}
'

Cabeçalhos (Headers)

NomeDescrição
x-delbank-api-keyObrigatório. Chave de API
IdempotencyKeyObrigatório. Chave idempotência da requisição. Informe um GUID, sendo um novo cada requisição.

Corpo da requisição (Body)

NomeTipoDescrição
amountnumberObrigatório. Valor da transferência
beneficiaryAccountstringObrigatório. Número da conta beneficiária
descriptionstringDescrição sobre a transferência. Essa informação será mostrada a conta beneficiária
externalIdstringIdentificação externa para conciliação no sistema cliente. Este valor será retornado na consulta da transferência (tanto via pagador quanto recebedor) e também será enviado via Webhook para a conta beneficiária

Resposta (Response)

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

Sendo bem-sucedido, o retorno irá trazer os seguintes campos em formato JSON:

🚧

Essas informações serão retornadas após a criação da transferência econsulta da transferência.

{
    "id": "b9f00a4a-f661-48fe-b873-08812473f972",
    "externalId": "D05082023174118B9F0",
    "transactionNsu": 722177,
    "status": "EFFECTIVE",
    "type": "INTERNAL",
    "amount": 0.01,
    "createdAt": "2023-08-05T17:41:18.583Z",
    "payer": {
        "number": "31712",
        "branch": "0001",
        "type": "CURRENT",
        "holder": {
            "document": "32752023000149",
            "name": "bxxdbde",
            "type": "LEGAL"
        },
        "participant": {
            "name": "DELBANK",
            "ispb": "38224857"
        }
    },
    "beneficiary": {
        "number": "10073",
        "branch": "0001",
        "type": "CURRENT",
        "holder": {
            "document": "10613462939",
            "name": "DOUGLAS VINÍCIUS DE ABREU",
            "type": "NATURAL"
        },
        "participant": {
            "name": "DELBANK",
            "ispb": "38224857"
        }
    }
}

📘

Para mais informações

Para mais informações e simulações de requisição deste endpoint, acesse o API Reference.