# PIX Payments for Brazilian SaaS: A Founder's Integration Guide

> Why PIX is now non-negotiable for Brazil-targeted SaaS, how the QR code flow works, BRL settlement realities, and the integration patterns that work in production.
- **Author**: Ayush Agarwal
- **Published**: 2026-05-11
- **Category**: Payments, SaaS, Brazil
- **URL**: https://dodopayments.com/blogs/pix-payments-brazilian-saas

---

If you sell software to Brazilian customers in 2026, the conversation about payment methods starts and ends with PIX. The Banco Central do Brasil's instant payment system has surpassed credit cards as the most-used payment method in Brazil. Customers expect to see it. Customers will skip checkouts that do not offer it. For SaaS founders entering or expanding in Brazil, integrating PIX is no longer optional.

This guide explains what PIX is, how the customer flow actually looks, the BRL settlement reality, the subscription gap that catches teams off guard, and the integration patterns that work in production.

## What PIX Is, Briefly

PIX is Brazil's instant payment system, launched by the central bank in 2020. It enables real-time bank transfers 24 hours a day, 365 days a year, including weekends and holidays. There is no waiting for bank processing windows. A PIX payment that fires at 3 AM Sunday confirms in seconds.

Customers initiate PIX in one of two ways:

- **QR code.** They scan a QR code with their banking app, which prefills the recipient and amount.
- **Copy-paste key.** They paste a long alphanumeric key into their banking app, which performs the same prefill.

Either way, the customer's bank confirms the payment to PIX, PIX confirms it to the merchant, and the transaction completes. End-to-end, PIX is faster than card payments, cheaper than card payments, and more secure than card payments because the customer is authenticated by their own bank.

For broader payment context, see our guides on [merchant of record in Brazil](https://dodopayments.com/blogs/merchant-of-record-brazil), [accept payments in Latin America](https://dodopayments.com/blogs/accept-payments-latin-america), and [best payment methods for SaaS](https://dodopayments.com/blogs/best-payment-methods-for-saas).

## Why PIX Matters for SaaS in Brazil

Three reasons PIX is non-negotiable for Brazil-targeted products.

### Reason 1: Market Share

PIX surpassed credit cards as the most-used digital payment method in Brazil. For consumer-facing products, not offering PIX means losing a meaningful percentage of buyers who default to PIX over cards. The exact share varies by category, but for SaaS targeting individuals or small businesses, PIX often captures 40-60% of attempted purchases.

### Reason 2: Cost

PIX has near-zero transaction fees. Compared to card payments, which typically run 4-7% in Brazil due to high local processing costs, PIX is dramatically cheaper. For high-volume, lower-value transactions, the cost difference materially affects unit economics.

### Reason 3: Trust

PIX is run by the central bank. Customers trust it the way they trust the banking system itself. There is no perception of risk or fraud associated with PIX in the way there sometimes is with card payments online. For categories where Brazilian customers are skeptical of foreign card processors, PIX provides a trusted alternative that gets the conversion.

## The Customer Flow

```mermaid
sequenceDiagram
    participant Customer
    participant Checkout
    participant Dodo
    participant PIX
    participant Bank
    
    Customer->>Checkout: Select PIX at checkout
    Checkout->>Dodo: Create payment
    Dodo->>PIX: Generate QR code
    PIX->>Customer: Display QR code and copy-paste key
    Customer->>Bank: Open banking app, scan or paste
    Bank->>PIX: Confirm payment
    PIX->>Dodo: Success callback
    Dodo->>Checkout: Payment complete
```

From the customer's perspective:

1. They select PIX at checkout.
2. The checkout page displays a QR code and a copy-paste key.
3. They open their banking app on their phone (most Brazilians have this on their phone).
4. They scan the QR code with the bank's PIX scanner, or paste the key into the bank's PIX entry field.
5. The bank shows them the recipient and amount, and asks them to confirm.
6. They confirm in the banking app.
7. The payment confirms instantly. The checkout page transitions to the success state.

End-to-end, this flow takes about 30-60 seconds. Faster than entering card details. No CVV, no 3D Secure, no SMS verification.

## The BRL Settlement Reality

PIX only works with BRL. There is no PIX-to-USD conversion at the consumer level. So if you target Brazilian customers, you need a billing currency of BRL on your PIX checkouts.

For non-Brazilian SaaS using a merchant of record like Dodo Payments, this gets handled at the platform level. The MoR collects BRL from the customer via PIX and settles to your business account in your preferred currency (USD typically). You see USD in your wallet. The customer paid in BRL.

The conversion rate is typically the FX rate at the time of settlement, less a small spread. So a R$100 sale at an exchange rate of 5 BRL per USD becomes ~$20 USD in your wallet, less the platform's processing fee. The exact net depends on your fee schedule.

For more on FX and settlement mechanics, see our [global billing](https://dodopayments.com/blogs/global-billing) and [multi-currency pricing for global SaaS](https://dodopayments.com/blogs/multi-currency-pricing-global-saas) guides.

## The Subscription Gap

This is the catch that surprises teams new to PIX: PIX does not natively support recurring payments.

Each PIX transaction is a single, one-time push from the customer's bank to the recipient. There is no equivalent of a card-on-file or a saved payment method. So if your SaaS is monthly-subscription, you cannot put PIX on a standard recurring checkout and expect renewals to work.

What this means in practice:

- For one-time purchases, PIX is perfect.
- For annual subscriptions paid as a one-time annual fee, PIX works.
- For monthly recurring subscriptions, you need either a card on file alongside PIX, or you need to engineer a renewal-via-PIX flow that prompts the customer to pay each month.

Many Brazilian SaaS deal with this by offering annual plans paid via PIX with a clear discount, or by sending PIX renewal reminders to customers each month with a fresh payment link. Both work but require more product thought than a standard card-on-file recurring subscription.

> The subscription gap with PIX is real but solvable. Annual-billed products convert beautifully on PIX because the customer pays once and is done. Monthly products need to either accept that some customers will use PIX for the first month and a card for renewals, or build a renewal nudge that fires before each cycle.
>
> - Ayush Agarwal, Co-founder & CPTO at Dodo Payments

## Configuration

The integration code for PIX is short.

```javascript
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_annual', quantity: 1 }],
  allowed_payment_method_types: ['pix', 'credit', 'debit'],
  billing_currency: 'BRL',
  customer: {
    email: 'cliente@example.com.br',
    name: 'Pedro Silva'
  },
  billing_address: {
    country: 'BR',
    zipcode: '01310-100'
  },
  return_url: 'https://yoursite.com/success'
});
```

Three details to get right.

1. **Billing currency must be BRL.** PIX does not work with USD, EUR, or any other currency. The currency at checkout must be BRL.
2. **Always include card fallbacks.** Some Brazilian customers prefer cards. Others may not have PIX set up despite it being widespread. Always include `credit` and `debit` as backup methods.
3. **Billing country should be Brazil.** While PIX is technically tied to the currency rather than the country, setting the billing country to BR ensures the right experience and any country-specific rules apply correctly.

For the implementation specifics, see the [Dodo Payments PIX documentation](https://docs.dodopayments.com/features/payment-methods/pix).

## Handling QR Code Expiration

PIX QR codes have a lifetime. They do not stay valid forever. If a customer abandons the checkout and returns 30 minutes later, the QR code may have expired. Common QR code lifetimes are 5-15 minutes for retail-style transactions.

Your checkout needs to handle this gracefully:

- Show a countdown timer on the QR code so customers know they need to act
- Detect expiration and offer to regenerate the QR code with a fresh payment session
- For longer-running checkouts (slow customer decision-making), consider sending the customer a payment link they can return to later, which generates a fresh QR code on demand

This is one of the few PIX-specific UX considerations that does not exist for card payments.

## Testing PIX Integrations

PIX testing is straightforward in sandbox mode.

1. Set your environment to test mode with sandbox API keys.
2. Set the billing currency to BRL.
3. When prompted for a Pix CPF, use the test value (your processor's docs will specify this).
4. A test QR code generates. Scan it with your phone's normal camera (no PIX app required for the test).
5. You are redirected to a test payment page where you can simulate success or failure.

The flow mirrors production except no real money moves. Use this to validate your webhook handling, your success/failure UX, and your QR code expiration logic before going live.

## Webhook Patterns for PIX

Because PIX confirms instantly when the customer pays, your webhook handling can be simpler than for cards. There is rarely a "pending" state to manage. The two main events:

- `payment.succeeded` fires when the PIX payment completes.
- `payment.failed` fires if the QR code expires without payment, or if some bank-side error occurs.

For one-time products, this is enough. The customer pays, the webhook fires, you grant access.

For annual subscriptions, you mark the subscription active on `payment.succeeded` and schedule a renewal reminder for 11 months later (giving the customer a month to act before the year ends).

For monthly subscriptions where you have engineered a PIX-renewal flow, each month's payment is treated as a fresh PIX transaction. Your subscription state machine listens for the monthly `payment.succeeded` event and extends the subscription by another billing period.

For broader webhook patterns, see our [webhooks for payment notifications](https://dodopayments.com/blogs/webhooks-payment-notifications) guide and the [Dodo Payments webhooks documentation](https://docs.dodopayments.com/developer-resources/webhooks).

## Common PIX Mistakes

### Mistake 1: Forgetting the Currency

The most common error: shipping a PIX checkout with billing currency in USD or some other non-BRL currency. PIX simply does not appear. Customers who specifically chose your product because they expected to pay via PIX bounce when they cannot find the option.

### Mistake 2: No Card Fallback

Always include card payments as a backup. Even in Brazil, some customers prefer cards. Some may have PIX issues at the moment of checkout. A checkout without card fallbacks loses these conversions.

### Mistake 3: Treating PIX Like a Card

PIX is not a card. There is no recurring billing. There is no chargeback in the card-network sense. Disputes work differently. If you build PIX into a subscription flow without thinking through the renewal mechanics, customers will hit confusing failure states at the second billing cycle.

### Mistake 4: Hardcoding Brazilian Tax Treatment

Brazil has unique tax rules for digital products and SaaS. The merchant of record handles tax in most platforms, but if you are doing it yourself, you need to register for the right tax IDs and remit on the right schedule. PIX does not change the tax obligation, but it does mean payment evidence is generated faster, so the audit trail is sharper.

For Brazilian tax context, see our [merchant of record in Brazil](https://dodopayments.com/blogs/merchant-of-record-brazil) and [global VAT GST for AI SaaS](https://dodopayments.com/blogs/global-vat-gst-ai-saas) guides.

### Mistake 5: Not Pricing Locally

PIX pays in BRL. If you are pricing in USD with a real-time conversion, the BRL amount the customer sees may shift between the moment they see the price and the moment they generate the QR code. This creates micro-friction. Better to set explicit BRL prices for the Brazilian market and let the platform settle to your preferred currency.

## A Real Brazilian Setup

Imagine a productivity SaaS targeting Brazilian small businesses with a R$49 a month plan and a R$490 annual plan.

- The monthly plan checkout offers cards and PIX (PIX with a clear note that the monthly renewal will need re-payment via PIX or a card on file)
- The annual plan checkout offers cards and PIX prominently. Most Brazilian customers will choose PIX here because the discount plus the simplicity of one-payment-and-done make it attractive
- Pricing is set in BRL directly, not converted from USD on the fly
- The MoR settles to the business in USD weekly
- Renewal reminders fire 30 days before the annual renewal, giving customers ample time to repay via PIX

This setup converts well, keeps unit economics clean, and avoids the renewal failure traps that come with treating PIX like a card.

## When to Skip PIX

Skip PIX if:

- You do not target Brazilian customers
- Your product is purely monthly-subscription with no annual option and you do not want to engineer a renewal flow
- You are doing direct-contracted enterprise sales where PIX is irrelevant

For most SaaS targeting Brazilian consumers, prosumers, or small businesses, PIX should be the first payment method on the list. Cards are the fallback. Not the other way around.

## FAQ

### Can I accept PIX without being a Brazilian company?

Yes, through a merchant of record. The MoR holds the local relationships and infrastructure to accept PIX from Brazilian customers and settles to you in USD or your preferred currency. You do not need a Brazilian entity, a Brazilian bank account, or local tax registration if your MoR handles it.

### How long does PIX settlement take?

PIX confirms instantly between the customer's bank and the recipient. From there, the merchant of record settles to your business on its standard payout schedule. So the customer's payment is confirmed instantly, but the funds reach your bank account on the platform's regular cycle (often weekly or bi-monthly).

### Can I use PIX for B2B SaaS?

Yes, especially for SMB B2B targeting Brazilian small businesses. The owner of the business often pays personally via PIX and reimburses through their company. For larger enterprise B2B with procurement teams, PIX is less relevant; those buyers typically want bank transfers or invoicing.

### What about chargebacks on PIX?

PIX does not have chargebacks in the credit card network sense. The customer authorizes the payment from their own bank account, so there is no card network for them to dispute through. There are dispute mechanisms via the central bank's PIX rules, but they are narrower and slower than card chargebacks. For most SaaS, PIX has materially lower dispute risk than cards.

### Does PIX work for foreign customers visiting Brazil?

PIX is tied to Brazilian bank accounts. A foreign visitor without a Brazilian bank account cannot pay via PIX. So PIX is a payment method for residents and citizens, not visitors. For tourist or short-term-visitor markets, cards remain the primary method.

## Final Take

PIX is the cheapest, fastest, and most-used digital payment method in Brazil. For SaaS targeting Brazilian customers, integrating PIX is a tier-zero priority. The technical effort is minimal. The conversion lift is significant. The economics are dramatically better than card-only checkouts in Brazil.

The main thing to design around is the subscription gap. PIX does not support recurring payments natively, so monthly subscriptions need either a card-on-file fallback or an engineered renewal flow. Annual plans paid via PIX bypass this entirely and are usually the highest-converting option for Brazilian audiences.

Get the configuration right, handle QR code expiration cleanly, and price in BRL. Do those three things and PIX becomes the highest-leverage payment method addition you make this year for Brazilian markets. Visit [dodopayments.com](https://dodopayments.com) for the integration patterns and [dodopayments.com/pricing](https://dodopayments.com/pricing) for transparent fee details.
</content>
</invoke>
---
- [More Payments articles](https://dodopayments.com/blogs/category/payments)
- [All articles](https://dodopayments.com/blogs)