Due-date QR Code Guide
This guide explains how to issue PIX charges with a due date — the Pix “CobV” charge, with interest, penalty, discount and deduction.
Overview
The due-date QR Code is a single-use charge, like the Dynamic QR Code, but with boleto-style rules: it has a due day, an identified debtor and charges that change the amount according to the payment date. It fits:
- Monthly fees and invoices - Charges with a set payment date
- Boleto replacement - Same due date and charges, settled over Pix
- Installment plans - One charge per installment, each with its own due date
The due-date QR Code must be enabled for your tenant. Without it, creation
returns 403 feature_disabled. Ask the CorpX team to enable it.
Integration Flow
Step 1: Issue the charge
Request
Body Parameters
The QR accepts payment until 23:59:59 (Brasília) on dueDate + daysAfterDueDate.
That day cannot be more than 365 days from today. deduction + discount
must be lower than value.
Success Response (201 Created)
Step 2: Look up and cancel
Lookup and cancellation are the same as for the dynamic QR, by identifier:
The lookup returns type: "due-date" and the same due-date fields as the
creation response (dueDate, daysAfterDueDate, charges, finalValue,
debtor, receiverName). Statuses are those of the
dynamic QR;
EXPIRED means the last payment day passed without payment.
Step 3: Receive the webhook
Payment arrives as qrcode.paid, with data.type = "due-date". data.amount
is the amount actually paid, which may differ from value: discount up to
the due date, interest and penalty after it.
Reconcile by identifier and compare data.amount with the amount you
expect for the payment date. Without payment by expiresAt, you receive
qrcode.expired.
Permissions
The route uses the same scope as the dynamic QR, qrcode.manage (or
api2/write). In the integrator dashboard, issuance requires the Issue
due-date and Pix Location QR codes permission.
Common Errors
Next Steps
- Pix Location - QR printed before the amount is known
- Webhooks - Configure notifications
- Refund Guide - Refund received payments