Introduction
Boleto uses a redirect-based payment flow. When a customer selects Boleto at checkout, they are redirected to dLocal’s hosted page where a Boleto ticket is generated. The customer can then pay using the barcode or numeric code at a bank, ATM, or via internet banking, then return to your site upon completion. Boleto is a single-use payment method where a new ticket must be generated for each transaction. This guide explains the process of integrating Boleto into your app or website using Payrails.Pre-requisites
Before you start accepting Boleto payments with Payrails, there are a few requirements you must meet:Ways to integrate Boleto
Payrails SDK
Server-to-server integration
Parse Boleto from lookup response
Pass Boleto 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,
10039 for R$100.39.Boleto is a redirect-based, single-use payment method. After calling the authorize endpoint, the customer will be redirected to a hosted page where they can view and pay the Boleto ticket. Once payment is 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
After the customer pays the Boleto and returns to your site, verify the payment status by checking the workflow execution status via the Payrails API or by listening to webhook notifications. Note that Boleto payments may take up to 1 business day to confirm after the customer completes payment at a physical location.Supported currencies
Boleto via dLocal supports the following presentment currency:- BRL — Brazilian Real
Supported regions / countries
Customer regions
Boleto is available to customers based in:- Brazil 🇧🇷