API Reference
Log In
API Reference

Batch transfer between Delbank bank accounts

This endpoint is for making multiple transfers to different Delbank bank accounts at once

Batch transfer between Delbank bank accounts

To transfer to several Delbank accounts, you only need to inform the beneficiary bank account numbers.

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

NameDescription
x-delbank-api-keyRequired. API key
IdempotencyKeyRequired. Requisition's idempotency key. Inform a GUID, being new to every requisition.

Body

NameTypeDescription
externalIdstringExternal 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
amountnumberRequired. Transfer amount.
beneficiaryAccountNumberstringRequired. Beneficiary account number.
[
	{
    "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

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": "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": []
    }
]