1. Home
  2. Blog
  3. Payments

PIX payment gateway: what it is, how it works, how to choose

Learn what a PIX payment gateway is, how QR Code charges, webhooks and reconciliation work in Brazil, and what to compare before choosing a provider.

Payments

A PIX payment gateway is the service that connects your company's system to PIX, Brazil's instant payment network: it creates the charge, tells your system the moment the customer pays and hands you the data to reconcile every payment. Instead of sharing a PIX key and checking the bank statement by hand, you create a charge with its own identifier, and the confirmation arrives on its own within seconds. For any business receiving dozens or thousands of payments a month, that is the difference between accepting PIX and running on PIX.

What a PIX gateway is and what it solves

PIX is the instant payment system created and operated by the Banco Central do Brasil, Brazil's central bank, and launched in November 2020. It runs 24 hours a day, every day, and money leaves one account and lands in another in a few seconds. In Brazil it is used for everything from splitting a restaurant bill to paying for online orders.

Anyone can receive money with a PIX key, which is an alias such as an email address, phone number or company tax ID. The trouble starts when volume grows. A key on its own does not tell you which order a payment belongs to, customers can type the wrong amount, and someone has to open the statement to release each sale.

A gateway solves three problems:

  • Identification: each charge has a unique code, so your system knows exactly which order was paid.
  • Automation: confirmation arrives by webhook, with no one watching the statement.
  • Reconciliation: reports and transaction data match what actually landed in the account.

Behind every gateway there is an institution that participates in PIX, which can be the provider itself or a partner bank. That matters when you choose, as you will see below.

How a PIX charge works through a gateway

The flow is similar across most providers:

  1. Your system calls the gateway's API and requests a charge with an amount, an expiry time and the order identifier.
  2. The gateway returns a dynamic QR Code and a copy-and-paste code.
  3. The customer opens their banking app and pays.
  4. The payment settles through the central bank's infrastructure in seconds.
  5. The gateway sends a webhook to your system saying that charge has been paid.
  6. Your system releases the order, issues the ticket, activates the subscription or triggers delivery.

Two identifiers show up in almost every integration. The txid is the code you or the gateway assigns to the charge. The endToEndId is the code PIX itself gives the transaction. Store both: they let you trace a payment, answer a customer and process refunds.

Types of charges a PIX gateway can offer

Not every provider offers everything. Use the table as a list of questions for your sales call.

TypeHow it worksWhen to use it
Static QR CodeSame code for many payments, amount optionalCounter sales, donations, open amounts
Dynamic QR CodeUnique code per charge, with amount and expiryE-commerce, checkout, apps
Charge with due dateHas a due date and can include late fees, interest and discountsInvoices and bills that used to go out as boletos
PIX AutomáticoThe customer authorizes once and recurring charges are paid without new approvalSubscriptions, plans, utility bills
RefundFull or partial return of a payment receivedCancellations and reimbursements

PIX Automático, the recurring payment option, went live in June 2025 and changed the math for subscription businesses that used to depend on credit cards or on reminding customers every month. If recurring revenue is at the center of your model, ask whether the gateway already supports it and how the authorization works.

What to compare before choosing a PIX gateway

The fee gets attention first, but it is rarely what causes the most trouble later. Compare these points:

  • Payout timing: is the money available right away, or does the provider hold it for a period? That affects your cash every single day.
  • Who the institution is: is the provider a PIX participant, or does it operate through a partner bank? Law 12.865/2013 is the legal framework for payment arrangements and payment institutions supervised by the central bank. Ask whose name the money sits under until it is paid out to you.
  • API quality: clear documentation, a sandbox and real examples can save weeks of integration work.
  • Webhooks: are notifications retried automatically when your server fails? Are they signed so you can confirm they really came from the gateway?
  • Reconciliation: do reports include txid, endToEndId, fee and net amount per transaction?
  • Payment splitting: marketplaces and platforms need to divide each payment among recipients at the source.
  • Support: who answers when a payment goes missing at 11 p.m. on a Saturday?
  • Fraud handling: how does the provider deal with MED, the central bank's Special Refund Mechanism, which can block and return funds in cases of suspected fraud or operational failure?

How much it costs and how to run the numbers

Providers charge in different ways: a percentage of the amount, a flat fee per transaction, a monthly plan or a mix. No model is cheapest for everyone. It depends on your average ticket.

Here is an example with hypothetical numbers that do not represent any provider's pricing: one gateway charges 0.8% per transaction and another charges a flat R$ 1.50.

ScenarioAverage ticketCharges per monthCost at 0.8%Cost at flat R$ 1.50
Low-priced storeR$ 302,000R$ 480R$ 3,000
High-ticket serviceR$ 4002,000R$ 6,400R$ 3,000

In this example, the break-even point is R$ 187.50 per transaction, which is R$ 1.50 divided by 0.8%. Below that, the percentage is cheaper. Above it, the flat fee wins. Run the same calculation with your real ticket and add monthly fees, withdrawal fees and refund costs before you compare offers.

Integrate a gateway or run your own processing

For most companies, integrating an existing gateway is the right call: it takes less time and leaves the technical operation to people who do it every day. Building your own setup only pays off when volume is high, when payments are part of the product, or when you need rules no provider offers.

During integration, the same mistakes keep coming up:

  • Releasing the order from the app's success screen instead of from the webhook or an API query.
  • Not handling duplicate notifications, which can release the same order twice.
  • Creating QR Codes with long expiry times for sales with limited stock.
  • Not storing the endToEndId, which makes any refund harder.

Bridgemoon runs its own payment processing system, including a PIX gateway, and builds systems, websites and mobile apps with payments already integrated. If you are working out how to accept PIX in your business, write to sales@bridgemoon.com.br.

Frequently asked questions

What is the difference between a PIX key and a PIX gateway?

A PIX key is only the address the money goes to, such as an email, phone number or company tax ID. A gateway is the software that creates identified charges, confirms payment automatically and organizes the data for reconciliation. For a handful of sales, a key is enough. At volume, a gateway saves hours of manual checking and prevents mistakes when releasing orders.

Does PIX have chargebacks like credit cards?

PIX has no chargebacks in the credit card sense. It has the Special Refund Mechanism, known as MED, created by the central bank for cases of suspected fraud or operational failure, which can lead to funds being blocked and returned. Ask your gateway how it notifies you and handles these cases.

How fast does PIX money reach my account?

The payment between the customer's bank and the receiving institution happens in seconds. What varies is the payout from the gateway to your account: some release funds immediately, while others hold them for a period set in the contract. Check that period before signing, because it directly affects your cash flow.