Esse endpoint serve para fazer múltiplas transações entre contas Delbank diferentes
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.
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 '[
{
"amount": 1,
"beneficiaryAccountNumber": "10138"
},
{
"amount": 2,
"beneficiaryAccountNumber": "37990"
},
{
"amount": 3,
"beneficiaryAccountNumber": "10073"
},
{
"amount": 4,
"beneficiaryAccountNumber": "32743"
}
]'
Headers
| Name | Description |
|---|---|
| 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. |
Body
| Name | Type | Description |
|---|---|---|
| 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"
}
]
Response
O status code 200 indicará sucesso na transação.
Sendo bem-sucedido, o retorno trará os seguintes campos no formato JSON:
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": []
}
]