curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/split-payments/payouts?beneficiaryDocument=12345678909&status=FAILED&paymentDateFrom=2026-10-01&paymentDateTo=2026-10-26' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'
[
{
"id": "5d2e8f1a-7c3b-4e9d-a6f0-1b2c3d4e5f60",
"order": {
"id": "b4c5d6e7-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
"source": "QR_CODE",
"grossAmount": 50.00,
"tariffAmount": 0.00,
"splitBaseAmount": 50.00,
"createdAt": "2026-10-20T10:15:00.000Z"
},
"status": "FAILED",
"transferType": "PIX_MANUAL",
"instructionType": "FIXED",
"instructionAmount": 5.00,
"amount": 5.00,
"paymentDate": "2026-10-20",
"beneficiary": {
"number": "123456",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "12345678909",
"name": "MARIA SOUZA",
"type": "NATURAL"
},
"participant": {
"ispb": "00000000",
"name": "BANCO EXEMPLO S.A."
}
},
"executedTransactionId": "c9d8e7f6-a5b4-4c3d-9e2f-1a0b9c8d7e6f",
"endToEndId": "E00000000202610201015fedcba654321",
"failureReason": "Conta do beneficiário inexistente ou encerrada",
"paidAt": null,
"canceledAt": null,
"cancelReason": null,
"createdAt": "2026-10-20T10:15:02.000Z",
"updatedAt": "2026-10-20T10:15:09.000Z"
}
]
Repasses
Listar repasses
Liste os repasses da conta de recebimento, com filtros por beneficiário, status e data do repasse.
GET
/
baas
/
api
/
v1
/
split-payments
/
payouts
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/split-payments/payouts?beneficiaryDocument=12345678909&status=FAILED&paymentDateFrom=2026-10-01&paymentDateTo=2026-10-26' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'
[
{
"id": "5d2e8f1a-7c3b-4e9d-a6f0-1b2c3d4e5f60",
"order": {
"id": "b4c5d6e7-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
"source": "QR_CODE",
"grossAmount": 50.00,
"tariffAmount": 0.00,
"splitBaseAmount": 50.00,
"createdAt": "2026-10-20T10:15:00.000Z"
},
"status": "FAILED",
"transferType": "PIX_MANUAL",
"instructionType": "FIXED",
"instructionAmount": 5.00,
"amount": 5.00,
"paymentDate": "2026-10-20",
"beneficiary": {
"number": "123456",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "12345678909",
"name": "MARIA SOUZA",
"type": "NATURAL"
},
"participant": {
"ispb": "00000000",
"name": "BANCO EXEMPLO S.A."
}
},
"executedTransactionId": "c9d8e7f6-a5b4-4c3d-9e2f-1a0b9c8d7e6f",
"endToEndId": "E00000000202610201015fedcba654321",
"failureReason": "Conta do beneficiário inexistente ou encerrada",
"paidAt": null,
"canceledAt": null,
"cancelReason": null,
"createdAt": "2026-10-20T10:15:02.000Z",
"updatedAt": "2026-10-20T10:15:09.000Z"
}
]
Funcionalidade em beta. Contrato em proposta, sujeito a mudanças. Veja o guia Acompanhar repasses.
beneficiaryDocument para mostrar a um beneficiário o histórico dos repasses dele.
Headers
string
required
Sua API key.
string
required
Número da conta de recebimento.
Query params
string
CPF ou CNPJ do beneficiário, somente números.
string
Status do repasse:
SCHEDULED, PENDING, PROCESSING, PAID, FAILED ou CANCELED.string
Forma do repasse:
INTERNAL ou PIX_MANUAL.string
Data inicial do repasse, no formato
YYYY-MM-DD.string
Data final do repasse, no formato
YYYY-MM-DD.number
default:"1"
Número da página (começa em 1).
number
default:"20"
Itens por página. Máximo de 100.
Response
Array de repasses. Os dados de paginação vêm no headerPagination, descrito em Paginação.
string
Identificador do repasse. Use-o para cancelar o repasse.
object
Recebimento com split que gerou o repasse. Mostra o valor integral do pagamento, a origem das instruções e a base de cálculo, sem precisar de outra consulta. É o mesmo recurso retornado por Consultar recebimento com split.
Show order
Show order
string
Identificador do recebimento com split: o id da transação de crédito, o mesmo do extrato e do webhook de recebimento. Use-o em Consultar recebimento com split.
string
ACCOUNT_CONFIGURATION (split padrão da conta) ou QR_CODE (split por cobrança).number
Valor integral do pagamento recebido.
number
Tarifa de split descontada antes do cálculo.
0 quando não há.number
Base de cálculo dos repasses (
grossAmount - tariffAmount).string
Data e hora do recebimento, em ISO 8601.
string
SCHEDULED, PENDING, PROCESSING, PAID, FAILED ou CANCELED. Veja o significado de cada um em Status do repasse.string
INTERNAL ou PIX_MANUAL.string
Tipo da instrução que gerou o repasse:
PERCENTAGE ou FIXED.number
Percentual ou valor definido na instrução.
number
Valor calculado do repasse, em reais.
string
Data prevista do repasse, no formato
YYYY-MM-DD. Nesta fase, é sempre a data do recebimento.object
Conta do beneficiário, no mesmo formato usado nas transferências.
Show beneficiary
Show beneficiary
string
Número da conta do beneficiário.
string
Agência da conta do beneficiário.
string
Tipo da conta do beneficiário:
PAYMENT, CURRENT ou SAVING.object
string
Id da transferência que executou o repasse (transferência interna ou Pix).
null enquanto o repasse não é executado.string
Identificador do Pix, em repasses
PIX_MANUAL.string
Motivo da falha, quando o status é
FAILED.string
Data e hora em que o repasse foi pago, em ISO 8601.
string
Data e hora do cancelamento, em ISO 8601.
string
Motivo informado no cancelamento.
string
Data e hora de criação do repasse, em ISO 8601.
string
Data e hora da última mudança de status, em ISO 8601.
Paginação
A resposta é um array. Os dados de paginação vêm no headerPagination:
Header
Pagination: {"currentPage":1,"pageSize":20,"pageCount":1,"rowCount":1,"totalAmount":5.00}
| Campo | Descrição |
|---|---|
currentPage | Página retornada |
pageSize | Itens por página (limit) |
pageCount | Total de páginas |
rowCount | Total de repasses encontrados |
totalAmount | Soma do amount de todos os repasses encontrados, considerando todas as páginas |
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/split-payments/payouts?beneficiaryDocument=12345678909&status=FAILED&paymentDateFrom=2026-10-01&paymentDateTo=2026-10-26' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'
[
{
"id": "5d2e8f1a-7c3b-4e9d-a6f0-1b2c3d4e5f60",
"order": {
"id": "b4c5d6e7-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
"source": "QR_CODE",
"grossAmount": 50.00,
"tariffAmount": 0.00,
"splitBaseAmount": 50.00,
"createdAt": "2026-10-20T10:15:00.000Z"
},
"status": "FAILED",
"transferType": "PIX_MANUAL",
"instructionType": "FIXED",
"instructionAmount": 5.00,
"amount": 5.00,
"paymentDate": "2026-10-20",
"beneficiary": {
"number": "123456",
"branch": "0001",
"type": "CURRENT",
"holder": {
"document": "12345678909",
"name": "MARIA SOUZA",
"type": "NATURAL"
},
"participant": {
"ispb": "00000000",
"name": "BANCO EXEMPLO S.A."
}
},
"executedTransactionId": "c9d8e7f6-a5b4-4c3d-9e2f-1a0b9c8d7e6f",
"endToEndId": "E00000000202610201015fedcba654321",
"failureReason": "Conta do beneficiário inexistente ou encerrada",
"paidAt": null,
"canceledAt": null,
"cancelReason": null,
"createdAt": "2026-10-20T10:15:02.000Z",
"updatedAt": "2026-10-20T10:15:09.000Z"
}
]