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.
A guide to PIX for businesses in Brazil: static vs dynamic QR codes, due-date billing, API integration and how to match every payment to the right order.

Using PIX for businesses takes more than sharing a key: to sell at scale, you need to create one charge per order with a dynamic QR code and receive automatic payment confirmation in your system. PIX is Brazil's instant payment system, created and run by the Banco Central do Brasil and launched in November 2020, and it settles in seconds, at any hour, straight into the recipient's account. The real work lies in tying each payment to the right order without manual checking.
A company can register its CNPJ (the Brazilian company tax ID), an email address, a phone number or a random key as its PIX key. The key works like an address: it tells the payer's bank which account receives the money, but not which order the payment belongs to.
When customers type the key and choose the amount themselves, the store has to work out later who paid for what. With two orders of the same value on the same day, matching by amount and name becomes guesswork. That may be enough for a small counter shop. It is not enough for e-commerce, apps or customer billing.
A static QR code carries fixed data: the key and, optionally, an amount. It can be printed and used many times. A dynamic QR code is generated for each charge and points to an address at the provider, where the payer's banking app fetches the details: amount, expiry, recipient data and the identifier of that specific charge.
| Feature | Static QR code | Dynamic QR code |
|---|---|---|
| Amount | Optional and fixed | Set per charge |
| Use | Reusable | One per charge |
| Order identification | Limited | Unique charge identifier |
| Expiry | Does not expire | Can expire |
| Reconciliation | Manual or by amount | Automatic |
| Typical use | Donations, simple counters | Online stores, apps, invoices |
Always show PIX Copia e Cola next to the QR code. It is the same payload as text, which the customer copies and pastes into the banking app. People buying on a phone cannot scan their own screen, so the copy button must be visible and work with a single tap.
An immediate charge is the checkout kind: the customer pays now, and the QR code expires after minutes or hours, according to the rule you set. It suits online stores, delivery, ticketing and any purchase made on the spot.
A due-date charge has a payment date and can include late fees, interest, early-payment discounts and rebates. It plays the role that boleto, a Brazilian bank payment slip, usually plays for monthly fees and invoices, with the advantage of clearing instantly. Some boletos also carry a printed PIX QR code, so the customer can choose how to pay.
In practice, many companies use both: immediate charges at checkout and due-date charges for monthly invoices or corporate billing.
To automate the process, the company connects its own system to its PIX provider's API. The Banco Central do Brasil published a standardized specification, the API Pix, which many institutions follow, making it easier to switch providers. The typical flow:
A few technical safeguards prevent headaches:
With dynamic charges, daily reconciliation is simple: each payment in the provider's statement matches a charge, and each charge matches an order. What is left over are PIX transfers sent straight to the key without a charge, which need manual review. Ideally this check feeds directly into your ERP or finance system.
Refunds are made through the API or the dashboard, in full or in part, always linked to the original transaction. Like a card refund, it is your decision, used for cancellations and returns.
There is also the Special Return Mechanism, known as MED, created by the Banco Central do Brasil for fraud and operational failures. In this case, the payer's institution starts the request, and funds may be blocked in your account during the review. Keep proof of delivery and service so you can respond.
A common scam is the fake receipt: a customer sends an image of a PIX transfer that never happened. Release orders only on confirmation from your own system or bank statement, never on a screenshot.
Bridgemoon has its own payment processing system with PIX and builds the integration with the client's store, app or ERP, from creating the charge to closing the order automatically.
A static code holds fixed data, can be reused and does not identify the order. A dynamic code is generated for each charge and carries the amount, expiry and a unique identifier, which lets your system confirm payment and close the order automatically.
Usually, yes. Each institution sets the fees it charges companies, which can be a percentage or a flat amount per transaction. Compare offers based on your volume and the services included, such as API access, webhooks and refunds.
Never release an order based on an image or screenshot sent by the customer. Confirm payment through the provider's authenticated webhook or the account statement. With integrated dynamic charges, the system only releases the order once the money has actually arrived.