Skip to main content
Pix is the instant payment system of the Central Bank of Brazil. Customers pay by scanning a QR code, or copying a Pix code, in their banking app. Payrails processes Pix through Adyen and dLocal. The flow is the same with each one, but the required request fields differ. Pick a PSP below for its setup steps and request examples. For recurring Pix payments, see Pix Automático.

​
How a Pix payment works

Pix is a QR code payment method:
  1. The customer selects Pix at checkout.
  2. Payrails returns a redirect URL to a page that shows the Pix QR code.
  3. The customer scans the code, or copies it, and confirms the payment in their banking app.
  4. Payrails receives the final result from the PSP and updates the payment.
Each payment is single-use: the customer confirms every payment on its own. Payrails captures Pix payments immediately, so a successful payment is final. To return funds, refund the payment.

​
Supported currencies and countries

Pix supports BRL (Brazilian real) as its only presentment currency.

​
Integrate Pix

Choose the PSP that processes Pix for you. Each guide covers the PSP-side setup, the Payrails configuration and the request fields that PSP requires.

Adyen

Pix via Adyen

dLocal

Pix via dLocal

​
Compare PSPs

Save Instruments and merchant-initiated transactions (MIT) aren’t available for Pix. To charge a customer on a schedule, use Pix Automático.

​
Ways to integrate Pix

  • Payrails SDK: the Web SDK shows Pix when your workflow returns it as a payment option, and opens the QR code page for the customer. To control how the redirect opens, listen for the actionRequired event.
  • Payrails API: call lookup payment options, then authorize with pix as the paymentMethodCode. Each PSP guide lists the meta fields that PSP requires.
In both cases, confirm the final result through webhook notifications or the execution status. The customer pays in a separate app, so a return to your site isn’t proof of payment.
Last modified on October 2, 2026