Skip to main content
O boleto bancário é amplamente utilizado no Brasil para cobranças com data de vencimento, especialmente em contextos B2B, educação, condomínios e assinaturas onde o pagador prefere não usar cartão ou Pix. A API permite emitir dois tipos de boleto, um convencional e outro com QR Code Pix integrado.
Antes de emitir qualquer boleto, sua conta precisa ser habilitada como Cedente (emissor autorizado de boletos). Solicite essa configuração pelo e-mail clientes@delbank.com.br.

Tipos de boleto

BANKSLIP

Boleto bancário convencional. Pago exclusivamente pela linha digitável ou código de barras, em qualquer agência bancária, app ou internet banking.

BANKSLIP_PIX

Boleto com QR Code Pix integrado. O pagador pode escolher pagar pelo código de barras do boleto ou escaneando o QR Code Pix. Liquidação instantânea quando pago via Pix.
Se você quer cobranças com vencimento pagas apenas via Pix, use a Cobrança com Vencimento (cobv). O BANKSLIP_PIX é ideal quando você quer oferecer as duas opções de pagamento no mesmo documento.

Conceitos importantes

Carteiras (wallets)

A carteira define como o boleto é emitido e quem gera o ourNumber:
CarteiraTipo de cobrançaourNumber
112SimplificadaGerado automaticamente pela Delfinance — não envie o campo
121ExpressaGerado por você — envie o campo ourNumber na criação

ourNumber e yourNumber

  • ourNumber (“Nosso Número”): identificador do boleto para a Delfinance, exibido no documento. Na carteira 112, é gerado automaticamente. Na carteira 121, você gera e envia.
  • yourNumber (“Número do Documento”): identificador do boleto para você, exibido como referência no documento. Sempre obrigatório.
  • correlationId: identificador para conciliação interna, deve ser um GUID único por boleto.

Encargos

CampoO que éTipos aceitos
discountDesconto por antecipação (até 3 datas escalonadas)Fixed, Percentage
lateFineMulta aplicada após o vencimentoFixed, Percentage
latePaymentJuros por dia/mês após o vencimentoFixed, Percentage

Status do boleto

StatusSignificado
PendingEmitido, aguardando pagamento
PaidPago pelo pagador
ExpiredVencido sem pagamento registrado
CancelledBaixado/cancelado pela API

Próximos passos

Emitir boleto

Crie boletos convencionais ou com QR Code Pix, com ou sem encargos.

Consultar boleto

Consulte por correlationId ou faça buscas paginadas por período.

Gerenciar boleto

Altere o vencimento, baixe/cancele ou faça download do PDF.

Simular pagamento

Simule a conclusão de um pagamento no ambiente sandbox.