Transferência em lote entre contas Delbank
Para transferir para várias contas Delbank, so será necessário informar os números de conta bancária.
- URL
- cURL
POST 'https://apisandbox.delbank.com.br/baas/api/v1/transfers/batch'
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/transfers/batch' \
--header 'Content-Type: application/json-patch+json' \
--header 'IdempotencyKey: 8ea756b5-897a-44a1-bd15-ba94a30ef86b' \
--header 'accept: text/plain' \
--header 'x-delbank-api-key: PJPyJ2xGmyB9oDHyNIUwNOt1dgpgolBwcE16ybaKD5qyPF7mnDAIp3DU7lrh6Q+aGXdyXbNadpWwrpX7YeUyssHInV1E823VibR+KhYK4NGys1ihS2gvjqW1P3Rm59rb' \
--data '[
{
"externalId": "{{guid}}",
"amount": 1,
"beneficiaryAccountNumber": "10138"
},
{
"externalId": "{{guid}}",
"amount": 2,
"beneficiaryAccountNumber": "37990"
},
{
"externalId": "{{guid}}",
"amount": 3,
"beneficiaryAccountNumber": "10073"
},
{
"externalId": "{{guid}}",
"amount": 4,
"beneficiaryAccountNumber": "32743"
}
]'
Headers
| Nome | Descrição |
|---|---|
| x-delbank-api-key | Obrigatório. Chave de API |
| IdempotencyKey | Obrigatório. Chave de idempotência da requisição. Informe um GUID, sendo novo em cada requisição. |
Corpo da Requisição
| Nome | Tipo | Descrição |
|---|---|---|
| externalId | string | Identificação externa para reconciliação no sistema do cliente. Este valor será retornado durante a consulta de transferência (tanto via pagador quanto beneficiário). Webhook para a conta do beneficiário |
| amount | number | Obrigatório. Valor da transferência. |
| beneficiaryAccountNumber | string | Obrigatório. Número da conta do beneficiário. |
[
{
"externalId": "555171d8-0c55-4fd5-978d-25733d3cbb68",
"amount": 1,
"beneficiaryAccountNumber": "10138"
},
{
"externalId": "cbd675ff-ba9a-4f1e-8850-62bf6a496f38",
"amount": 2,
"beneficiaryAccountNumber": "37990"
},
{
"externalId": "3e44cde3-fd21-4969-9954-de5d44226a88",
"amount": 3,
"beneficiaryAccountNumber": "10073"
},
{
"externalId": "db9d5cab-8647-4bd4-a5b1-e6738b51dd2d",
"amount": 4,
"beneficiaryAccountNumber": "32743"
}
]
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": "f235ad70-be15-4216-b791-eb75c86c0ad4",
"type": {
"id": 1,
"name": "INTERNAL",
"description": "Transferência interna"
},
"status": "DONE",
"amount": 1.0,
"createdAt": "2024-12-05T21:04:41.7533699Z",
"transferAt": "2024-12-05T21:04:41.7533699Z",
"transferredAt": "2024-12-05T21:04:41.7533699Z",
"sender": {
"number": "36013",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "07034346593",
"name": "Wesley Alves Santana",
"email": "[email protected]",
"type": "NATURAL"
},
"bank": {
"code": "0435",
"name": "DELCRED SCD S.A.",
"nameFantasy": "DELBANK",
"ispbCode": "38224857"
}
},
"recipient": {
"number": "10138",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "11468192000181",
"name": "FIDC DELCRED",
"email": "[email protected]",
"type": "LEGAL"
},
"bank": {
"code": "0435",
"name": "DELCRED SCD S.A.",
"nameFantasy": "DELBANK",
"ispbCode": "38224857"
}
},
"tags": []
},
{
"id": "a406649b-c298-4cf8-8d9b-27e0f43155c0",
"type": {
"id": 1,
"name": "INTERNAL",
"description": "Transferência interna"
},
"status": "DONE",
"amount": 2.0,
"createdAt": "2024-12-05T21:04:41.8261637Z",
"transferAt": "2024-12-05T21:04:41.8261637Z",
"transferredAt": "2024-12-05T21:04:41.8261637Z",
"sender": {
"number": "36013",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "4545454546593",
"name": "Alves Santana",
"email": "[email protected]",
"type": "NATURAL"
},
"bank": {
"code": "0435",
"name": "DELCRED SCD S.A.",
"nameFantasy": "DELBANK",
"ispbCode": "38224857"
}
},
"recipient": {
"number": "37990",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "999999921567",
"name": "EDUARDO",
"email": "[email protected]",
"type": "NATURAL"
},
"bank": {
"code": "0435",
"name": "DELCRED SCD S.A.",
"nameFantasy": "DELBANK",
"ispbCode": "38224857"
}
},
"tags": []
},
{
"id": "d4257999-d350-4ee5-9a5d-52ec3d346cdc",
"type": {
"id": 1,
"name": "INTERNAL",
"description": "Transferência interna"
},
"status": "DONE",
"amount": 3.0,
"createdAt": "2024-12-05T21:04:41.8372496Z",
"transferAt": "2024-12-05T21:04:41.8372496Z",
"transferredAt": "2024-12-05T21:04:41.8372496Z",
"sender": {
"number": "36013",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "07034346593",
"name": "Wesley Alves Santana",
"email": "[email protected]",
"type": "NATURAL"
},
"bank": {
"code": "0435",
"name": "DELCRED SCD S.A.",
"nameFantasy": "DELBANK",
"ispbCode": "38224857"
}
},
"recipient": {
"number": "10073",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "10613462939",
"name": "DOUGLAS ABREU DE VINÍCIUS",
"email": "[email protected]",
"type": "NATURAL"
},
"bank": {
"code": "0435",
"name": "DELCRED SCD S.A.",
"nameFantasy": "DELBANK",
"ispbCode": "38224857"
}
},
"tags": []
},
{
"id": "0e53992c-4f32-4270-ae0e-8f1b85cb8ceb",
"type": {
"id": 1,
"name": "INTERNAL",
"description": "Transferência interna"
},
"status": "DONE",
"amount": 4.0,
"createdAt": "2024-12-05T21:04:41.8464382Z",
"transferAt": "2024-12-05T21:04:41.8464382Z",
"transferredAt": "2024-12-05T21:04:41.8464382Z",
"sender": {
"number": "36013",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "07034346593",
"name": "Wesley Alves Santana",
"email": "[email protected]",
"type": "NATURAL"
},
"bank": {
"code": "0435",
"name": "DELCRED SCD S.A.",
"nameFantasy": "DELBANK",
"ispbCode": "38224857"
}
},
"recipient": {
"number": "32743",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "12345678911",
"name": "DOUGLA ABREU",
"email": "[email protected]",
"type": "NATURAL"
},
"bank": {
"code": "0435",
"name": "DELCRED SCD S.A.",
"nameFantasy": "DELBANK",
"ispbCode": "38224857"
}
},
"tags": []
}
]