curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/split-payments/configurations' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
"bankAccountNumber": "CONTA_PAGADORA",
"instructions": [
{
"amount": 10,
"type": "PERCENTAGE",
"transferType": "INTERNAL",
"beneficiary": {
"number": "CONTA_BENEFICIARIA"
}
}
]
}'
{
"id": 15,
"bankAccountNumber": "CONTA_PAGADORA",
"createdAt": "2025-09-19T20:04:38.112Z",
"updatedAt": "2025-09-19T20:04:38.112Z",
"instructions": [
{
"id": 18,
"splitPaymentConfigurationId": 15,
"amount": 10,
"type": "PERCENTAGE",
"transferType": "INTERNAL",
"beneficiary": {
"number": "CONTA_BENEFICIARIA",
"branch": "0001",
"participantIspb": "12345678",
"type": "PAYMENT",
"holder": {
"document": "12345678901",
"name": "Nome do Beneficiário",
"email": null,
"phoneNumber": null,
"type": "NATURAL"
}
}
}
]
}
Split de Pagamentos
Criar configuração de Split
Crie uma configuração de Split de Pagamento com uma ou mais instruções de repasse.
POST
/
baas
/
api
/
v1
/
split-payments
/
configurations
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/split-payments/configurations' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
"bankAccountNumber": "CONTA_PAGADORA",
"instructions": [
{
"amount": 10,
"type": "PERCENTAGE",
"transferType": "INTERNAL",
"beneficiary": {
"number": "CONTA_BENEFICIARIA"
}
}
]
}'
{
"id": 15,
"bankAccountNumber": "CONTA_PAGADORA",
"createdAt": "2025-09-19T20:04:38.112Z",
"updatedAt": "2025-09-19T20:04:38.112Z",
"instructions": [
{
"id": 18,
"splitPaymentConfigurationId": 15,
"amount": 10,
"type": "PERCENTAGE",
"transferType": "INTERNAL",
"beneficiary": {
"number": "CONTA_BENEFICIARIA",
"branch": "0001",
"participantIspb": "12345678",
"type": "PAYMENT",
"holder": {
"document": "12345678901",
"name": "Nome do Beneficiário",
"email": null,
"phoneNumber": null,
"type": "NATURAL"
}
}
}
]
}
Para o passo a passo completo, incluindo exemplos por tipo de repasse, veja o guia Configurar Split de Pagamentos.
Headers
string
required
Sua API key.
string
required
Número da conta Delfinance.
Body
string
required
Conta onde os pagamentos serão recebidos e divididos.
array
required
Lista de instruções de repasse.
Show propriedades do item
Show propriedades do item
number
required
Valor a ser aplicado, conforme o
type selecionado.string
required
Como o
amount é calculado. Valores aceitos:PERCENTAGE: o valor é calculado como uma porcentagem do pagamento total. O percentual máximo permitido por instrução é 5%.FIXED: o valor é fixo e absoluto. Se o valor especificado exceder 50% do valor da transação, o split não é realizado para aquela instrução naquele pagamento.
string
required
Meio pelo qual o beneficiário recebe o valor. Valores aceitos:
INTERNAL: repasse entre contas da mesma titularidade. Recomendado e totalmente suportado. Basta informarbeneficiary.number; os demais dados do beneficiário são preenchidos automaticamente.PIX_MANUAL: repasse via dados bancários informados manualmente. Recomendado e totalmente suportado, com validação completa dos dados enviados.EXTERNAL: aceito pela API, mas ainda sem validação específica dos dados bancários informados. Não recomendado para produção.PIX_KEY: ainda não funcional nesta rota. Não utilize até que o suporte seja anunciado.
object
required
Dados da conta de destino. Os campos exigidos variam conforme o
transferType (veja o guia Configurar Split de Pagamentos).Show propriedades
Show propriedades
string
required
Número da conta de destino (2 a 25 caracteres). Único campo obrigatório para
transferType: INTERNAL.string
Agência da conta de destino (1 a 10 caracteres). Para
INTERNAL, é preenchida automaticamente e qualquer valor enviado é sobrescrito.string
ISPB da instituição de destino (exatamente 8 caracteres). Para
INTERNAL, é preenchido automaticamente e qualquer valor enviado é sobrescrito.string
Tipo da conta de destino. Valores aceitos:
PAYMENT, CURRENT, SAVING, SALARY, ESCROW, MINIPI, ADMINISTERED, TRANSACTIONAL, OWNER. Para INTERNAL, é preenchido automaticamente e qualquer valor enviado é sobrescrito.object
Dados do titular da conta de destino. Para
INTERNAL, name e document são preenchidos automaticamente e qualquer valor enviado é sobrescrito.Show propriedades
Show propriedades
Response
number
Identificador único da configuração de split.
string
Conta de recebimento informada na criação.
string
Data/hora de criação em ISO 8601.
string
Data/hora da última atualização em ISO 8601.
array
Lista de instruções cadastradas na configuração.
Show propriedades
Show propriedades
number
Identificador único da instrução.
number
Configuração à qual a instrução pertence.
number
Valor configurado para a instrução.
string
PERCENTAGE ou FIXED.string
INTERNAL, PIX_MANUAL, EXTERNAL ou PIX_KEY.object
Dados da conta de destino.
Show propriedades
Show propriedades
string
Número da conta de destino.
string
Agência da conta de destino.
string
ISPB da instituição de destino.
string
Tipo da conta de destino.
curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/split-payments/configurations' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
"bankAccountNumber": "CONTA_PAGADORA",
"instructions": [
{
"amount": 10,
"type": "PERCENTAGE",
"transferType": "INTERNAL",
"beneficiary": {
"number": "CONTA_BENEFICIARIA"
}
}
]
}'
{
"id": 15,
"bankAccountNumber": "CONTA_PAGADORA",
"createdAt": "2025-09-19T20:04:38.112Z",
"updatedAt": "2025-09-19T20:04:38.112Z",
"instructions": [
{
"id": 18,
"splitPaymentConfigurationId": 15,
"amount": 10,
"type": "PERCENTAGE",
"transferType": "INTERNAL",
"beneficiary": {
"number": "CONTA_BENEFICIARIA",
"branch": "0001",
"participantIspb": "12345678",
"type": "PAYMENT",
"holder": {
"document": "12345678901",
"name": "Nome do Beneficiário",
"email": null,
"phoneNumber": null,
"type": "NATURAL"
}
}
}
]
}
⌘I