PIX payment gateway: how online businesses accept PIX payments in Brazil
What PIX is, why most Brazilians pay online with it, how a PIX payment gateway works from QR code to webhook, the costs and risks, and a checklist for choosing one.
9 min read
If you sell online to customers in Brazil, there is one payment method you cannot skip: PIX. In only a few years it went from a new central-bank project to the way most Brazilians pay — for groceries, bills, online shopping, game top-ups and transfers between friends.
This guide explains what PIX is, why it matters for online businesses, how a PIX payment gateway works from the moment the customer clicks "pay" to the moment your system marks the order paid, what it costs, the risks to watch and a checklist for choosing a provider.
What is PIX?
PIX is the instant payment system of Banco Central do Brasil (BCB), launched in November 2020. Every bank, digital bank and payment institution of a meaningful size in Brazil is required to offer it, so almost every Brazilian with a bank account or wallet can pay by PIX.
What makes PIX different from a normal bank transfer:
- Instant, 24/7. A PIX payment settles in seconds, at night, on weekends and on public holidays.
- Paid by QR code or key. The payer scans a QR code or types a "PIX key" (an email, phone number, tax ID or random key) instead of a long account number.
- Low cost. For individuals, sending a PIX is free. For businesses, receiving a PIX is usually much cheaper than a card payment.
- Final. Once paid, the money has moved. There is no chargeback like with cards (there is a fraud-return process, explained below).
Why PIX matters for online businesses
The numbers explain it. According to payment-industry reports, PIX now handles billions of transactions every month — figures of 7 to 8 billion per month were reported in the first half of 2026 — and accounts for more than half of all payment transactions in Brazil, ahead of credit and debit cards combined. Daily records above 300 million transactions have been reported.
For an online business this means three things:
- Higher conversion. Many Brazilians do not have a credit card, or do not want to use it online. PIX lets them pay from the bank app they already use.
- Faster cash flow. A PIX payment is confirmed in seconds, so you can deliver digital goods, credit a balance or ship the order immediately.
- Fewer disputes. There is no card-style chargeback, which matters a lot for digital goods, gaming and top-ups.
If your checkout only offers cards, you are leaving a large part of the Brazilian market behind.
How a PIX payment works with a gateway
You could, in theory, give customers your own PIX key and check your bank statement by hand. That does not scale: you cannot match hundreds of payments to orders, you cannot know who paid which order, and your team becomes a manual reconciliation department.
A PIX payment gateway automates the whole flow:
| Step | What happens | Who does it |
|---|---|---|
| 1. Create a charge | Your website asks the gateway for a new PIX charge for the order amount | Your server, via API |
| 2. Show the QR | The gateway returns a dynamic PIX QR code and a "copy and paste" code | Gateway → your checkout |
| 3. Customer pays | The customer opens their bank app, scans or pastes the code and confirms | Customer |
| 4. Confirmation | The bank network confirms the payment in seconds | PIX network → gateway |
| 5. Webhook | The gateway sends a signed webhook to your server: this order is paid | Gateway → your server |
| 6. Fulfilment | Your system marks the order paid, delivers or credits the balance | Your server |
| 7. Settlement | Paid funds are made available and withdrawn | Gateway → your account |
The key is the dynamic QR code: it is created for one order and contains the exact amount and a unique identifier. When the payment arrives, the gateway knows exactly which order it belongs to — no guessing, no manual matching.
Static vs dynamic PIX QR
- A static QR is like a printed sign: the same code for every payment, sometimes without an amount. It is fine for a small shop counter, not for an online store.
- A dynamic QR is created per order, with the amount fixed and an expiry time. This is what online businesses need, because every payment can be matched automatically.
What does a PIX gateway cost?
Pricing varies by provider and volume, but the usual elements are:
- A fee per paid transaction, as a percentage, a fixed amount or both. PIX is normally cheaper than cards.
- Withdrawal or settlement fees, when you move your funds out.
- Currency conversion, if you are a foreign business and want to receive another currency. Always ask how the rate is calculated and when it is fixed.
Questions worth asking: Do failed or expired charges cost anything? (They should not.) Is there a monthly fee or setup fee? How long until funds are available?
Risks and how to manage them
PIX is fast and final, which is good for merchants, but there are still things to watch.
Fake payment proofs. A customer sends a screenshot of a "PIX receipt" that was edited or never completed. The rule is simple: never deliver on a screenshot. Deliver only when your gateway's webhook says the charge is paid.
Wrong amounts. With static keys, customers may send the wrong amount. Dynamic QR codes fix the amount, which removes most of this problem.
Expired charges. A customer opens an old QR code and pays after it expired. Good gateways tell you clearly what happens then; your checkout should create a fresh charge rather than reuse an old one.
Fraud returns (MED). Brazil has a Special Return Mechanism (Mecanismo Especial de Devolução, MED) that lets a bank request money back when a PIX was made through fraud or a scam. It is not a chargeback for "I changed my mind", but you should keep good records of every order and delivery in case a payment is questioned.
Webhook reliability. If your server is down when the webhook arrives, you could miss a payment. Use a gateway that retries webhooks and lets you check a payment's status through the API.
PIX for gaming, trading and digital goods
PIX fits especially well with businesses that deliver instantly:
- Gaming and top-ups: credit the user's balance the second the webhook arrives.
- Trading platforms: take deposits in BRL with a clean record of every payment for reconciliation.
- Digital goods and subscriptions: deliver codes, licences or access immediately.
For these businesses, the combination of instant confirmation and no card chargebacks is a big advantage. It also means your integration must be correct: idempotent order handling (the same webhook twice must not credit twice) and signature checks on every webhook.
Checklist: choosing a PIX payment gateway
Before you sign up, check:
- Dynamic QR and copy-and-paste code for every charge.
- Signed webhooks with retries, plus an API to check a payment's status.
- A sandbox where you can simulate paid, failed and expired payments.
- Clear fees: per transaction, per withdrawal, and nothing on failed charges.
- Settlement options that work for your business (local account, foreign account or stablecoins).
- Reporting: gross, fee and net for every payment, exportable for your accountant.
- Support that answers in a language your team speaks.
- One API for several countries, if Brazil is not your only market.
Step by step: adding it to your website
- Create a merchant account and add your website.
- Create a sandbox API key and keep it on your server only — never in the browser or a mobile app.
- Set your webhook URL and save the webhook secret.
- At checkout, create a payment through the API with the order amount and your own order reference, then show the QR code or open the wallet link.
- Handle the webhook: verify the signature, find the order by your reference, and mark it paid only once even if the webhook arrives twice.
- Show the customer a result page, but treat it as information only — the webhook is the source of truth.
- Test every outcome in the sandbox: paid, failed and expired.
- Switch to a live key and watch the first real payments in the dashboard.
How PAYWISE handles Brazil
PAYWISE is an API-first payment platform. Indonesia (QRIS) and crypto payments are live today, and Brazil (PIX) opens on request: merchants who ask first are prepared first. When Brazil opens for your account, you use the same API, the same webhooks and the same dashboard you use for other countries — only the currency and payment method are new.
You can see the Brazil page and send a request in two minutes, or ask from your merchant dashboard under Payments → Other countries.
Frequently asked questions
Is PIX only for people with a bank account? PIX needs an account at a bank, digital bank or payment institution, but in Brazil that includes many free digital accounts, so most adults can pay by PIX.
How fast is a PIX payment confirmed? Usually within seconds, 24 hours a day, including weekends and holidays.
Can a customer cancel a PIX payment? Not like a card chargeback. A PIX is final; refunds are made by sending a new PIX back. Brazil's MED process can return money in cases of proven fraud.
Can a foreign company accept PIX? Yes, through a payment provider that collects in Brazil and settles to you. Ask the provider how funds are settled and converted.
What is the difference between a PIX key and a PIX QR code? A key identifies the receiver (email, phone, tax ID or random key). A dynamic QR code also carries the amount and a unique order reference, which is what lets a gateway match payments automatically.
Do I need a separate integration for each country? Not with a multi-country gateway. With PAYWISE, every country uses the same API.
Sources: Banco Central do Brasil — Pix, Matera — Pix by the Numbers Q2 2026, Matera — Pix by the Numbers Q1 2026, Gironews — Pix daily record. Figures from industry reports are indicative; check the Banco Central's Pix statistics for official numbers. This article is general information, not legal or financial advice.

