Gerenciar Boleto

Após emitir um boleto, você pode alterar sua data de vencimento, cancelar/baixar a cobrança ou gerar o PDF para envio ao pagador.

Alterar data de vencimento

Use PATCH /baas/v1/charges/:correlationId para atualizar a data de vencimento de um boleto pendente. Somente o campo dueDate pode ser alterado.

curl --location --request PATCH 'https://apisandbox.delbank.com.br/baas/v1/charges/304c439c-4b17-4a75-abb1-2526e356cdad' \
--header 'Content-Type: application/json' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '{
    "dueDate": "2026-03-31"
}'

A resposta de sucesso retorna 200 OK com o corpo vazio (text/plain). O boleto continua com o mesmo correlationId, ourNumber e código de barras — apenas o vencimento muda.

Só é possível alterar o vencimento de boletos com status Pending. Boletos expirados, pagos ou cancelados não podem ser modificados.

Baixar e cancelar boleto

Use PUT /baas/v1/charges/:correlationId/closeout para baixar (cancelar) um boleto. Após a baixa, o boleto não pode mais ser pago.

curl --location --request PUT 'https://apisandbox.delbank.com.br/baas/v1/charges/304c439c-4b17-4a75-abb1-2526e356cdad/closeout' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}'

A resposta de sucesso retorna 200 OK. Após a baixa, o status do boleto passa para Cancelled.

A baixa não cancela um pagamento já realizado. Se o boleto foi pago antes da solicitação de baixa, o pagamento permanece registrado normalmente.

Gerar PDF do boleto

Use GET /baas/v1/charges/:correlationId/stream para obter o boleto em formato PDF. A resposta é um stream binário com Content-Type: application/pdf.

cURL

curl --location 'https://apisandbox.delbank.com.br/baas/v1/charges/304c439c-4b17-4a75-abb1-2526e356cdad/stream' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--output boleto.pdf

O PDF gerado contém o código de barras e, para BANKSLIP_PIX, também o QR Code Pix impresso no documento.

Exemplo em código

Node.js

const response = await fetch(
  `https://apisandbox.delbank.com.br/baas/v1/charges/${correlationId}/stream`,
  {
    headers: {
      'x-delbank-api-key': apiKey,
      'x-delfinance-account-id': accountId,
    },
  }
);

const pdfBuffer = await response.arrayBuffer();
fs.writeFileSync('boleto.pdf', Buffer.from(pdfBuffer));

Referência da API

Atualizar boleto

PATCH /baas/v1/charges/:correlationId

Cancelar boleto

PUT /baas/v1/charges/:correlationId/closeout

Imprimir PDF

GET /baas/v1/charges/:correlationId/stream

Introdução

Autenticação

Receber via Pix (Pix Cash-in)

Pagar via Pix (Pix Cash-out)

Cobranças via Boleto

Split de Pagamentos

Webhooks

Alterar data de vencimento

Baixar e cancelar boleto

Gerar PDF do boleto

Exemplo em código

Referência da API

Atualizar boleto

Cancelar boleto

Imprimir PDF

​Alterar data de vencimento

​Baixar e cancelar boleto

​Gerar PDF do boleto

​Exemplo em código

​Referência da API

Atualizar boleto

Cancelar boleto

Imprimir PDF

Alterar data de vencimento

Baixar e cancelar boleto

Gerar PDF do boleto

Exemplo em código

Referência da API