Skip to main content
Pix is Brazil’s instant payment system created by the Central Bank of Brazil (Banco Central do Brasil). It enables real-time transfers 24/7, including weekends and holidays, and has become the most popular payment method in Brazil.

​
Why Offer Pix?

Dominant in Brazil

Pix is the most-used payment method in Brazil, surpassing credit cards and boleto.

Instant Settlement

Payments confirm in seconds, 24/7/365 — no waiting for bank processing windows.

Low Friction

Customers pay via QR code or copy-paste key — no card numbers or bank details needed.

​
Overview

DetailValue
Billing CurrencyBRL
Supported CountriesBrazil
SubscriptionsNo
Min Amount$0.50
SettlementInstant

​
How It Works

​
Customer Experience

  1. Customer selects Pix at checkout
  2. A QR code and copy-paste key are displayed
  3. Customer opens their banking app and scans the QR code or pastes the key
  4. Payment confirms instantly
  5. Customer is redirected to the success page
Pix QR codes typically expire after a set period. If the customer doesn’t complete payment in time, they need to restart the checkout.

​
Configuration

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['pix', 'credit', 'debit'],
  billing_currency: 'BRL',
  return_url: 'https://example.com/success'
});

​
API Method Type

TypeMethodCountry
pixPixBrazil

​
Testing

1

Enable test mode

Use your Dodo Payments test API keys.
2

Set billing currency to BRL

Ensure the billing currency is set to BRL in your checkout request.
3

Enter test CPF and scan the QR code

When prompted for a Pix CPF, enter 1234567890. A test QR code will be generated — scan it with your normal phone camera (no Pix app needed). You’ll be redirected to a Stripe test page where you can simulate the transaction as a success or failure.

​
Best Practices

Pix only works with BRL. Ensure your pricing supports Brazilian Real transactions for the Brazilian market.
Not all Brazilian customers may prefer Pix. Always include credit and debit as fallback options.
Pix QR codes expire after a set period. Ensure your checkout handles expiration gracefully and allows customers to regenerate the code.

​
Troubleshooting

Check:
  1. Billing currency set to BRL?
  2. pix included in allowed_payment_method_types?
  3. Customer billing country is Brazil?
Solution: Pix is only available for BRL transactions. Verify currency and billing address in your API request.
Cause: Customer didn’t complete payment within the expiration window.Solution: Customer needs to restart the checkout to generate a new QR code.
Cause: Pix payments confirm instantly in most cases, but occasional bank-side delays can occur.Solution: Monitor webhooks for payment confirmation. If payment doesn’t confirm within a few minutes, treat it as failed.

Payment Methods Overview

See all supported payment methods.

Adaptive Currency

Currency support and automatic conversion.

Checkout Guide

Complete checkout implementation guide.

Webhooks

Handle payment confirmations asynchronously.
Last modified on March 27, 2026