Skip to main content
PicPay is a digital wallet in Brazil. Customers pay from their PicPay account by scanning a QR code with the PicPay app. Payrails processes PicPay through dLocal as the payment service provider (PSP).

​
How a PicPay payment works

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

​
Supported currencies and countries

PicPay supports BRL (Brazilian real) as its only presentment currency. PicPay is available to customers based in:
RegionsCountries
Latin America🇧🇷 Brazil

​
Integrate PicPay

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

dLocal

PicPay via dLocal

​
Check PSPs

WorkflowdLocal
Payrails SDK✔
Payrails API✔
Delayed / Manual Capture✖
Instant Capture✔
Cancel / Void✖
Refund / Reverse✔
Save Instruments✖
Merchant Initiated Transaction (MIT)✖

​
Ways to integrate PicPay

  • Payrails SDK: the Web SDK shows PicPay when your workflow returns it as a payment option, and redirects the customer to the dLocal payment page. To control how the redirect opens, listen for the actionRequired event.
  • Payrails API: call lookup payment options, then authorize with picPay 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. Don’t treat the customer’s return to your success URL as proof of payment.
Last modified on October 16, 2026