curl --location --request DELETE 'https://apisandbox.delbank.com.br/baas/api/v1/split-payments/beneficiaries/6f1c2a9e-3b7d-4e8a-9c21-5d4f0e7b8a13' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'
{
"id": "6f1c2a9e-3b7d-4e8a-9c21-5d4f0e7b8a13",
"bankAccountNumber": "10050",
"externalId": "seller-4821",
"transferType": {
"name": "PIX_MANUAL",
"description": "Pix Manual",
"value": 2
},
"account": {
"number": "123456",
"branch": "0001",
"type": "CURRENT",
"participantIspb": "00000000",
"pixKey": null,
"holder": {
"document": "12345678909",
"name": "Maria Souza",
"type": "NATURAL"
}
},
"status": {
"name": "INACTIVE",
"description": "Inativo",
"value": 1
},
"createdAt": "2026-11-03T14:00:00.000Z",
"updatedAt": "2026-11-12T16:45:00.000Z"
}
Beneficiários
Inativar beneficiário
Inative um beneficiário. O cadastro não é apagado, mas deixa de gerar repasses.
DELETE
/
baas
/
api
/
v1
/
split-payments
/
beneficiaries
/
{id}
curl --location --request DELETE 'https://apisandbox.delbank.com.br/baas/api/v1/split-payments/beneficiaries/6f1c2a9e-3b7d-4e8a-9c21-5d4f0e7b8a13' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'
{
"id": "6f1c2a9e-3b7d-4e8a-9c21-5d4f0e7b8a13",
"bankAccountNumber": "10050",
"externalId": "seller-4821",
"transferType": {
"name": "PIX_MANUAL",
"description": "Pix Manual",
"value": 2
},
"account": {
"number": "123456",
"branch": "0001",
"type": "CURRENT",
"participantIspb": "00000000",
"pixKey": null,
"holder": {
"document": "12345678909",
"name": "Maria Souza",
"type": "NATURAL"
}
},
"status": {
"name": "INACTIVE",
"description": "Inativo",
"value": 1
},
"createdAt": "2026-11-03T14:00:00.000Z",
"updatedAt": "2026-11-12T16:45:00.000Z"
}
Funcionalidade em beta. Contrato em proposta, sujeito a mudanças. Veja o guia Cadastro de beneficiários.
status passa para INACTIVE. O cadastro não é apagado e continua aparecendo nas consultas.
Depois de inativado:
- os novos pagamentos de QR Codes que referenciam o beneficiário geram repasses em
ERROR, sem transferência, e o valor fica na conta de recebimento; - os repasses já criados não mudam. Os agendados continuam agendados e são executados na data. Para impedir um repasse agendado, cancele-o;
- o
externalIdfica livre para outro beneficiário ativo.
Headers
string
required
Sua API key.
string
required
Número da conta de recebimento.
Path params
string
required
Identificador do beneficiário (UUID).
Response
Retorna o beneficiário, comstatus.name igual a INACTIVE, na estrutura descrita em Cadastrar beneficiário.
Erros
| HTTP | Código | Quando acontece |
|---|---|---|
404 | SPLIT_BENEFICIARY_NOT_FOUND | Não existe beneficiário com esse id na conta de recebimento |
curl --location --request DELETE 'https://apisandbox.delbank.com.br/baas/api/v1/split-payments/beneficiaries/6f1c2a9e-3b7d-4e8a-9c21-5d4f0e7b8a13' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'
{
"id": "6f1c2a9e-3b7d-4e8a-9c21-5d4f0e7b8a13",
"bankAccountNumber": "10050",
"externalId": "seller-4821",
"transferType": {
"name": "PIX_MANUAL",
"description": "Pix Manual",
"value": 2
},
"account": {
"number": "123456",
"branch": "0001",
"type": "CURRENT",
"participantIspb": "00000000",
"pixKey": null,
"holder": {
"document": "12345678909",
"name": "Maria Souza",
"type": "NATURAL"
}
},
"status": {
"name": "INACTIVE",
"description": "Inativo",
"value": 1
},
"createdAt": "2026-11-03T14:00:00.000Z",
"updatedAt": "2026-11-12T16:45:00.000Z"
}