Skip to main content
POST
/
baas
/
v1
/
charges
curl --location 'https://apisandbox.delbank.com.br/baas/v1/charges' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
    "type": "BANKSLIP_PIX",
    "correlationId": "{{$guid}}",
    "yourNumber": "PED-2024-001",
    "dueDate": "2025-12-30",
    "Amount": 150.00,
    "payer": {
        "name": "João Alves",
        "document": "07034346593",
        "email": "joao@email.com",
        "phone": { "prefix": "79", "number": "988669383" },
        "address": {
            "zipCode": "49010030",
            "publicPlace": "AV. RIO BRANCO",
            "neighborhood": "CENTRO",
            "number": "186",
            "city": "ARACAJU",
            "state": "SE"
        }
    }
}'

{
    "type": "BANKSLIP_PIX",
    "correlationId": "69577abe-3867-4e0b-85ee-21aa6bc9db9b",
    "amount": 150.00,
    "walletNumber": "112",
    "yourNumber": "PED-2024-001",
    "ourNumber": "00000532665",
    "dueDate": "2025-12-30T23:59:59.999Z",
    "qrCode": "00020101021226770014br.gov.bcb.pix2555pix-h.delbank.com.br/v2/cobv/vcharge00000000000003246005204000053039865802BR5907DELBANK6007ARACAJU62070503***63045ED1",
    "qrCodeImageBase64": "data:image/png;base64,iVBORw0KGgoAAAANSU...",
    "barCode": "43599110300000000100001112000001700000532665",
    "digitableLine": "43590001161200000170600005326657911030000000010",
    "payer": {
        "name": "JOÃO ALVES",
        "document": "07034346593",
        "email": "joao@email.com",
        "phone": { "prefix": "79", "number": "988669383" },
        "address": {
            "zipCode": "49010030",
            "publicPlace": "AV. RIO BRANCO",
            "neighborhood": "CENTRO",
            "number": "186",
            "city": "ARACAJU",
            "state": "SE"
        }
    },
    "status": "Pending",
    "payments": [],
    "createdAt": "2025-02-05T20:59:24.019Z",
    "updatedAt": "2025-02-05T20:59:25.016Z"
}
Para o passo a passo completo, veja o guia Emitir Boleto.

​
Headers

​
x-delbank-api-key
string
required
Sua API key.
​
x-delfinance-account-id
string
required
Número da conta Delfinance.

​
Body

​
type
string
required
Tipo do boleto. Valores aceitos: BANKSLIP (convencional) ou BANKSLIP_PIX (com QR Code Pix integrado).
​
correlationId
string
required
GUID único para identificação e conciliação do boleto no seu sistema. Deve ser único por boleto.
​
yourNumber
string
required
Número do documento — identificador do boleto para você. Exibido no documento como referência.
​
ourNumber
string
Nosso número — identificador do boleto para a Delfinance. Obrigatório apenas para a carteira 121. Não envie para a carteira 112 (gerado automaticamente).
​
dueDate
string
required
Data de vencimento no formato YYYY-MM-DD.
​
Amount
number
required
Valor do boleto em reais (ex: 150.00).
​
payer
object
required
Dados do pagador (sacado).
​
discount
object
Desconto por antecipação (opcional). Até 3 faixas de datas.
​
lateFine
object
Multa aplicada após o vencimento (opcional).
​
latePayment
object
Juros por período após o vencimento (opcional).
​
finalBeneficiary
object
Beneficiário final da cobrança (para gateways e plataformas que emitem em nome de terceiros).

​
Response

​
type
string
Tipo do boleto: BANKSLIP ou BANKSLIP_PIX.
​
correlationId
string
GUID de conciliação.
​
amount
number
Valor do boleto.
​
walletNumber
string
Carteira utilizada: "112" ou "121".
​
yourNumber
string
Número do documento informado.
​
ourNumber
string
Nosso número (gerado ou informado).
​
dueDate
string
Data de vencimento em ISO 8601.
​
barCode
string
Código de barras do boleto.
​
digitableLine
string
Linha digitável para pagamento.
​
qrCode
string
Payload do QR Code Pix. Presente apenas para BANKSLIP_PIX.
​
qrCodeImageBase64
string
Imagem do QR Code em base64 (data:image/png;base64,...). Presente apenas para BANKSLIP_PIX.
​
status
string
Status inicial: Pending.
​
payments
array
Lista de pagamentos registrados (vazia na criação).
​
createdAt
string
Data/hora de criação em ISO 8601.
​
updatedAt
string
Data/hora da última atualização em ISO 8601.
curl --location 'https://apisandbox.delbank.com.br/baas/v1/charges' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
    "type": "BANKSLIP_PIX",
    "correlationId": "{{$guid}}",
    "yourNumber": "PED-2024-001",
    "dueDate": "2025-12-30",
    "Amount": 150.00,
    "payer": {
        "name": "João Alves",
        "document": "07034346593",
        "email": "joao@email.com",
        "phone": { "prefix": "79", "number": "988669383" },
        "address": {
            "zipCode": "49010030",
            "publicPlace": "AV. RIO BRANCO",
            "neighborhood": "CENTRO",
            "number": "186",
            "city": "ARACAJU",
            "state": "SE"
        }
    }
}'

{
    "type": "BANKSLIP_PIX",
    "correlationId": "69577abe-3867-4e0b-85ee-21aa6bc9db9b",
    "amount": 150.00,
    "walletNumber": "112",
    "yourNumber": "PED-2024-001",
    "ourNumber": "00000532665",
    "dueDate": "2025-12-30T23:59:59.999Z",
    "qrCode": "00020101021226770014br.gov.bcb.pix2555pix-h.delbank.com.br/v2/cobv/vcharge00000000000003246005204000053039865802BR5907DELBANK6007ARACAJU62070503***63045ED1",
    "qrCodeImageBase64": "data:image/png;base64,iVBORw0KGgoAAAANSU...",
    "barCode": "43599110300000000100001112000001700000532665",
    "digitableLine": "43590001161200000170600005326657911030000000010",
    "payer": {
        "name": "JOÃO ALVES",
        "document": "07034346593",
        "email": "joao@email.com",
        "phone": { "prefix": "79", "number": "988669383" },
        "address": {
            "zipCode": "49010030",
            "publicPlace": "AV. RIO BRANCO",
            "neighborhood": "CENTRO",
            "number": "186",
            "city": "ARACAJU",
            "state": "SE"
        }
    },
    "status": "Pending",
    "payments": [],
    "createdAt": "2025-02-05T20:59:24.019Z",
    "updatedAt": "2025-02-05T20:59:25.016Z"
}