Skip to main content

Introduction

PicPay uses a redirect-based payment flow. When a customer selects PicPay at checkout, they are redirected to dLocal’s hosted page where a QR code is displayed. The customer scans the QR code using the PicPay app to authenticate and confirm payment, then is returned to your site upon completion. PicPay is a single-use payment method where customers must authenticate each payment. This guide explains the process of integrating PicPay into your app or website using Payrails.

Pre-requisites

Before you start accepting PicPay payments with Payrails, there are a few requirements you must meet:

Ways to integrate PicPay

Payrails SDK

Server-to-server integration

Parse PicPay from lookup response

Pass PicPay payment method in request to authorize payment with Payrails

Note on amountsBRL uses 2 decimal places. Amounts should be provided in the smallest currency unit—for example, 1500 for R$15.00.
PicPay is a redirect-based, single-use payment method. After calling the authorize endpoint, the customer will be redirected to a hosted page displaying a QR code. The customer scans this with the PicPay app to confirm payment. Once confirmed, the customer will be redirected back to the returnInfo.success URL. Make sure to provide valid returnInfo URLs in your authorization request.

Handle the redirect response

Supported currencies

PicPay via dLocal supports the following presentment currency:
  • BRL — Brazilian Real

Supported regions / countries

Supported workflows and services

Last modified on September 28, 2026