Registered boleto

Boleto that settles itself and accepts Pix on the same document.

Registered issuance, auto-settlement, reconciliation by metadata, and fine, interest and discount rules at creation. If the customer wants Pix, the QR is already on the boleto.

Create account Read the docs

Free issuance. Fee only when the boleto is paid.

Fee per paid boleto

0.50% + R$ 0.05
Settlement

D+1 business day
Included

Registry, settlement, Pix

How it works

From POST to auto-settlement

The whole cycle on one endpoint: registered issuance, delivery to customer, settlement when the bank clears it.

Issue the boleto

A POST with amount, due date and optional fine, interest and discount. The response has PDF, barcode and Pix QR.

The customer pays

At any bank, lottery outlet or via the embedded Pix. Clears in up to 1 business day, instantly if it's Pix.

It lands and reconciles

Signed boleto.paid webhook, automatic settlement and the metadata you sent comes back ready to match the order.

What's included

Infrastructure boleto, not display

No per-issue fee, no premium plan to see your statement, no 'registry' billed separately.

CIP registry

Every boleto ships registered, with date and value locked at the central. No CIP means no auto-settlement and no bank legality.

Auto-settlement

Paid, webhook lands, charge closes. No parsing CNAB files the next day, no manual reconciliation.

Boleto with Pix (Bolix)

The boleto ships with an embedded Pix QR. If the customer wants, they pay instantly and you skip the boleto fee.

Fine, interest, discount

Rules by percentage or fixed value, with a discount deadline, created alongside the boleto. No manual recalculation.

Automatic second copy

Endpoint to generate a new copy with a new due date, keeping the same external id. The customer gets the updated link.

Reconciliation by metadata

Tag order_id, tenant, anything on the POST. It comes back in the webhook, no scanning your statement for our name.

Proof

One POST creates the boleto with embedded Pix

Fine, interest, discount and Pix QR in the same request. The response returns the barcode and the PDF download link.

import { Ducavo } from '@ducavo/sdk';

const ducavo = new Ducavo(process.env.DUCAVO_SECRET_KEY);

const boleto = await ducavo.boleto.charges.create({
  amount: 32000,
  dueDate: '2026-08-15',
  customer: {
    name: 'ACME LTDA',
    taxId: '12345678000199',
    email: '[email protected]'
  },
  fine: { percentage: 2 },
  interest: { percentage: 1 }, // ao mês
  discount: { untilDate: '2026-08-10', amount: 1000 }
});

// Boleto com Pix embutido: cliente escolhe pagar via QR Code
console.log(boleto.barcode);
console.log(boleto.pixQrcode); // opcional

from ducavo import Ducavo

ducavo = Ducavo(os.environ['DUCAVO_SECRET_KEY'])

boleto = ducavo.boleto.charges.create(
    amount=32000,
    due_date='2026-08-15',
    customer={
        'name': 'ACME LTDA',
        'tax_id': '12345678000199',
        'email': '[email protected]',
    },
    fine={'percentage': 2},
    interest={'percentage': 1},
    discount={'until_date': '2026-08-10', 'amount': 1000},
)

# Boleto com Pix embutido: cliente escolhe pagar via QR Code
print(boleto.barcode)
print(boleto.pix_qrcode)

$ducavo = new Ducavo($_ENV['DUCAVO_SECRET_KEY']);

$boleto = $ducavo->boleto->charges->create([
    'amount' => 32000,
    'dueDate' => '2026-08-15',
    'customer' => [
        'name' => 'ACME LTDA',
        'taxId' => '12345678000199',
        'email' => '[email protected]',
    ],
    'fine' => ['percentage' => 2],
    'interest' => ['percentage' => 1],
    'discount' => ['untilDate' => '2026-08-10', 'amount' => 1000],
]);

echo $boleto->barcode;
echo $boleto->pixQrcode;

client := ducavo.New(os.Getenv("DUCAVO_SECRET_KEY"))

boleto, _ := client.Boleto.Charges.Create(&ducavo.BoletoParams{
    Amount:  32000,
    DueDate: "2026-08-15",
    Customer: &ducavo.Customer{
        Name:  "ACME LTDA",
        TaxID: "12345678000199",
        Email: "[email protected]",
    },
    Fine:     &ducavo.Percentage{Percentage: 2},
    Interest: &ducavo.Percentage{Percentage: 1},
    Discount: &ducavo.Discount{UntilDate: "2026-08-10", Amount: 1000},
})

fmt.Println(boleto.Barcode)
fmt.Println(boleto.PixQrcode)

Registered boleto with fine, interest, discount and embedded Pix.

Pricing

Free issuance, fee only when boleto is paid

You issue unlimited without spending. The fee kicks in when the payer settles.

Free to issue, R$ 0.50 if the customer picks Pix instead.

See the full pricing table

Paid boleto per settlement	0,50% + R$ 0,05
Boleto issuance unlimited	Free
Payment via embedded Pix per transaction	R$ 0,50
Monthly fee	Free

Fiscal edge

Boleto issued, invoice in the same request

Banks and platforms usually split boleto from invoicing into two flows. Here, the invoice object lives in the same POST as the boleto.

NFS-e issued when the boleto clears
Auto-cancellation on refund
Boleto and invoice PDFs on the same webhook

boleto-com-nf.ts

await ducavo.boleto.charges.create({
  amount: 32000,
  dueDate: '2026-08-15',
  invoice: {
    issue: true,
    cfop: '5102'
  }});

See the invoicing product

FAQ

Frequently asked questions about boleto

What's the boleto fee?

0.50% + R$ 0.05 per paid boleto. Issuance, CIP registry, auto-settlement and second-copy are free. If the payer picks the embedded Pix, the Pix fee (R$ 0.50) applies instead.

When does the money clear?

1 business day after bank settlement. If the payer wants speed, the boleto ships with an embedded Pix QR and settlement becomes instant.

Is CIP registry required?

It's the norm since 2018 and it's what enables auto-settlement, predictability and bank use. Every boleto issued by Ducavo already ships registered, with no registry fee.

How do fine, interest and discount work?

You declare them by percentage or fixed value directly in the POST, with a discount deadline. Ducavo applies them at settlement and the statement shows the breakdown.

What if the customer loses the boleto?

An endpoint generates a second copy with a new due date, keeping the same external id. The original boleto is cancelled and the new one ships already registered.

Can a boleto be paid at any bank?

Yes, at any bank, lottery outlet or banking app. Because it's registered, all channels recognize the number and display the value adjusted for the date.

Payment methods

Everything you need to get paid

One API, every payment method. Integrate once and offer Pix, card, boleto and more.

Start issuing boletos today

Open sandbox, unlimited test-mode issuance, production access released in minutes.

Create my account Talk to a specialist