For Your Business
- Reduced Delinquency: Payments are collected automatically, mitigating forgetfulness.
- Lower Costs: Generally cheaper than credit card fees and boleto issuance.
- Higher Conversion: Accessible to customers who don’t have credit cards.
- Immediate Settlement: Funds are available instantly, improving cash flow.
For Your Customers
- Convenience: “Set it and forget it” experience for recurring bills.
- Control: Easy management and cancellation via their banking app.
- No Fees: Typically free for individual payers (Pessoa Física).
- Safety: Built on the secure Pix infrastructure with established refund mechanisms.
- Utilities: Water, electricity, gas, and internet bills.
- Subscriptions: Streaming services, newspapers, and software (SaaS).
- Tuition: Schools, universities, and specialized courses.
- Financial Services: Insurance premiums, condos, and loan repayments.
Journey 2: QR Code Authorization
Journey 2: QR Code Authorization
Journey 3: QR Code Authorization + First Payment
Journey 3: QR Code Authorization + First Payment
automatic_pix object in the request body and set the type field according to the desired journey:
| Value | Journey | Description |
|---|---|---|
optional | Journey 2 | Authorization only — no immediate payment is charged. The payer subscribes to the recurring payment via QR Code. |
immediate | Journey 3 | First payment + authorization — the payer pays the first installment and subscribes to the recurring payment in a single step. |
Amount Types
When creating an authorization, you choose between two amount strategies by providing eitheramount or minimum_authorization_amount in the automatic_pix object.
Fixed amount
Provideamount to charge the same value every cycle. No PATCH is needed — the system automatically uses this value for every new schedule.
Variable amount
Provideminimum_authorization_amount (and authorization_amount as the pre-authorized ceiling) to support cycles with different values. This is required if you plan to update the charge amount before each billing date.
minimum_authorization_amount as the default value. If you want to charge a different amount for a specific cycle, use the Update Schedule endpoint to set a custom value before the schedule moves beyond Pending status.
| Scenario | Amount charged |
|---|---|
| PATCH sent before the cycle’s due date | Amount from the PATCH |
| No PATCH sent | minimum_authorization_amount |

