Transfer between Delbank bank accounts
To transfer to another Delbank account, you only need to inform the beneficiary bank account number.
Requisition
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"
}
'
Headers
| Name | Description |
|---|---|
| x-delbank-api-key | Required. API key |
| IdempotencyKey | Required. Requisition's idempotency key. Inform a GUID, being new to every requisition. |
Body
| Name | Type | Description |
|---|---|---|
| amount | number | Required. Transfer amount. |
| beneficiaryAccount | string | Required. Beneficiary account number. |
| description | string | Description about the transfer. This information will be shown to the beneficiary account. |
| externalId | string | External identification for reconciliation in the client system. This amount will be returned during the transfer query (both via payer and beneficiary).Webhook to the beneficiary account |
Response
The status code 200 will indicate success in the transaction.
Being successful, the return will bring the following fields in JSON format:
These informations will be returned after the transfer creation and transfer query.
{
"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": "FULANO DA SILVA",
"type": "NATURAL"
},
"participant": {
"name": "DELBANK",
"ispb": "38224857"
}
}
}
For more information
For more information and simulations about this endpoint requisition, access the API Reference.