Skip to main content
SmartPix is the dLocal Open Finance payment method in Brazil, built on Pix. Customers authorize the payment from their banking app instead of with a card. Payrails processes SmartPix through dLocal as the payment service provider (PSP).

​
How a SmartPix payment works

SmartPix is a redirect payment method:
  1. The customer selects SmartPix at checkout.
  2. Payrails returns a redirect URL from dLocal, and the customer goes to the dLocal payment page.
  3. The customer authorizes the Pix payment through their bank’s Open Finance flow.
  4. The customer returns to your returnInfo URL.
  5. Payrails receives the final result from dLocal and updates the payment.
Each payment is single-use: the customer authorizes every payment on its own. Payrails captures SmartPix payments immediately, so a successful payment is final. To return funds, refund the payment.

​
Supported currencies and countries

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

​
Integrate SmartPix

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

dLocal

SmartPix via dLocal

​
Check PSPs

​
Ways to integrate SmartPix

  • Payrails SDK: the Web SDK shows SmartPix when your workflow returns it as a payment option.
  • Payrails API: call lookup payment options, then authorize with smartPix as the paymentMethodCode. The PSP guide lists the meta fields that PSP requires.
In both cases, confirm the final result through webhook notifications or the execution status.
Last modified on October 5, 2026