Market specifications

Take a look of all the payment methods available.

Country reference Cards supported APM supported

Cards

Find all the information about the card supported capabilities.

Capabilities Process Card Payments

Alternative Payments

Learn how to integrate cash, bank transfer or wallet payment.

Boleto PIX Mercado Pago PicPay

Market specifications

Do you want to know more information about Brazil's market? Go to the Brazil’s economy and eCommerce market article.

Country reference

`country` code	`currency` code	`document` name	`document` format	`document` required?
`BR`	`BRL`	CPF or CNPJ	Between 11 to 14 digits Full CPF validation	Yes

Cards supported

`payment_method_id`	Brand ID	Name	`payment_method_type`	Details	Allowed Flows
`CARD`	`VI`	Visa	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`VD`	Visa Debit	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`MC`	Mastercard	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`MD`	Mastercard Debit	`CARD`	Debit Card	`DIRECT` `REDIRECT`
`CARD`	`AE`	American Express	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`EL`	Elo	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`ED`	Elo Debit	`CARD`	Debit Card	`DIRECT` `REDIRECT`
`CARD`	`MS`	Maestro	`CARD`	Debit Card	`DIRECT` `REDIRECT`
`CARD`	`HI`	Hipercard	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`DI`	Discover	`CARD`	Credit Card	`DIRECT` `REDIRECT`

ℹ️
To offer all the card options that may be available in your integration, send the payment_method_id as CARD.

Alternative Payment Method supported

`payment_method_id`	Name	`payment_method_type`	Details	Allowed Flows
`BL`	Boleto	`TICKET`	Cash Payment	`DIRECT` `REDIRECT`
`PQ`	PIX	`TICKET`	PIX	`DIRECT` `REDIRECT`
`MP`	Mercado Pago	`BANK_TRANSFER`	eWallet	`DIRECT` `REDIRECT`
`PZ`	PicPay	`TICKET`	eWallet	`REDIRECT`

Cards

Capabilities

To view the information for all the cards, position the cursor over the table and use the horizontal scroll to navigate.

	Visa Credit	Visa Debit	Mastercard Credit	Mastercard Debit	American Express	Elo	Elo Debit	Maestro	Hipercard	Discover
Minimum amount	1 BRL	1 BRL	1 BRL	1 BRL	1 BRL	1 BRL	1 BRL	1 BRL	1 BRL	1 BRL
Refunds	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Recurring	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Chargeback option	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Chargeback Dispute option	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Descriptor	Can be personalized, depending on the provider.	Can be personalized, depending on the provider.	Can be personalized, depending on the provider.	Can be personalized, depending on the provider.	Can be personalized, depending on the provider.	Can be personalized, depending on the provider.	Can be personalized, depending on the provider.	Can be personalized, depending on the provider.	Can be personalized, depending on the provider.	Can be personalized, depending on the provider.

How to process Card Payments?

Learn how to process payments with credit and debit cards with dLocal in our Card Payments section.

Alternative Payment Method

Boleto

Pay for online services, either over the counter at any supporting outlet in Brazil, or through internet banking.
It’s very popular in the country, where a significant number of consumers don't have a bank account.

The consumer is provided with a payment code (or barcode), which then uses to complete the payment either in cash or through home banking.

Capabilities

	Boleto
Min. amount	1 BRL
Max. expiration time supported	Up to 8 days
Notification delay	Immediate to 1 day, depending on the provider.
Refunds	Yes
Flow	`DIRECT` `REDIRECT`

Request parameters

Property	Type	Description	Mandatory?
`amount`	Number	Amount to be charged.	Yes
`currency`	String	`BRL` Transaction currency in ISO 4217.	Yes
`country`	String	`BR` Transaction country in ISO 3166.	Yes
`payment_method_id`	String	`BL` ID of the selected payment method.	Yes
`payment_method_flow`	String	`DIRECT` or `REDIRECT`	Yes
`payer.name`	String	Name of the payer.	Yes
`payer.email`	String	Email of the payer.	Yes
`payer.document`	Number	Document of the payer.	Yes
`order_id`	Number	ID of the capture given by the merchant in their system. Think of it as an external ID of the capture.	No
`notification_url`	String	Notifications will be sent in every change of status of a payment to the `notification_url` specified by the merchant.	No

Examples

{
    "amount": 100.39,
    "currency": "BRL",
    "country": "BR",
    "payment_method_id": "BL",
    "payment_method_flow": "DIRECT",
    "payer": {
        "name": "Pedro Gomes",
        "email": "[email protected]",
        "document": "11934254096"
    },
    "order_id": "34545sk3483kqw0",
    "description": "Tshirt",
    "notification_url": "http://merchantsite.com/notification/new",
    "callback_url": "http://merchantsite.com/success_page"
}

{
    "id": "D-4-1a64bdbd-faf5-473e-94b5-f96d36ef0d3f",
    "amount": 100.39,
    "currency": "BRL",
    "payment_method_id": "BL",
    "payment_method_type": "TICKET",
    "payment_method_flow": "DIRECT",
    "country": "BR",
    "ticket": {
        "type": "CUSTOM",
        "number": "10499136581700010014301792813733191730000010039",
        "expiration_date": "2022-11-18T20:25:19.000+0000",
        "id": "3087297622",
        "barcode": "10496917900000004029136517000100140179718690",
        "company_name": "DLOCAL BRASIL LTDA",
        "provider_name": "caixa",
        "provider_logo": "http://static.dlocal.com/images/providers/caixa.png",
        "image_url": "http://pay.dlocal.com/gmf/payments/M-cee70da0-0542-11e9-b88f-39144191f926"
    },
    "created_date": "2022-11-10T17:06:49.545+0000",
    "status": "PENDING",
    "order_id": "jhg4v34v534",
    "notification_url": "http://conductor.sandbox.internal/robot-server/rest/generic/notification/new"
}

Example ticket

Boleto UI built with the information in the example above.

User Interface Tips UI

If you are using this payment method through a DIRECT integration, follow the tips below in order to make it easier for your customers to complete payments, boosting your conversion rates.

Element	Tip
Ticket Number	Provide an option to copy the ticket.number. It’s a long number and users who pay through their home banking need to input it on their bank app/website.
Currency and Amount	Should be relevant elements in the ticket. Users need to have that information very clearly.
Currency Symbol	R$
Expiration date	Display this element clearly and visible enough. In Brazil, the date format is DD/MM/YYYY.
Barcode	It is useful for users that pay through home banking with a barcode reader, and for the ones that pay at physical stores. Format:`Interleaved 2 of 5 (ITF)`
Full Boleto View	Add a link to the full Boleto: ticket.image_url. Although it is not necessary to pay, some users prefer to have it as it gives them a sense of security. Check out a full Boleto example.

PIX

PIX is a Brazilian payment method, officially launched by the local Central Bank, that enables immediate payment confirmation and 24/7 availability. The user can complete the payment using any Home Banking or Ewallet App, by copying and pasting a Transaction ID or scanning a QR code (see example in the next section).

Capabilities

	PIX
Min. amount	1 BRL
Max. expiration time supported	Up to 6 days
Notification delay	Immediate
Refunds	Yes
Flow	`DIRECT` `REDIRECT`

Request parameters

Property	Type	Description	Mandatory?
`amount`	Number	Amount to be charged.	Yes
`currency`	String	`BRL` Transaction currency in ISO 4217.	Yes
`country`	String	`BR` Transaction country in ISO 3166.	Yes
`payment_method_id`	String	`PQ` ID of the selected payment method.	Yes
`payment_method_flow`	String	`DIRECT` or `REDIRECT`	Yes
`payer.name`	String	Name of the payer.	Yes
`payer.email`	String	Email of the payer.	Yes
`payer.document`	Number	Document of the payer.	Yes
`order_id`	Number	ID of the capture given by the merchant in their system. Think of it as an external ID of the capture.	No
`notification_url`	String	Notifications will be sent in every change of status of a payment to the `notification_url` specified by the merchant.	No

Examples

{
    "amount": 4,
    "currency": "BRL",
    "country": "BR",
    "payment_method_id": "PQ",
    "payment_method_flow": "DIRECT",
    "payer": {
        "name": "Pedro Gomes",
        "email": "[email protected]",
        "document": "11934254096"
     },
    "order_id": "34545sk3483kqw0",
    "description": "Tshirt",
    "notification_url": "http://merchantsite.com/notification/new",
    "callback_url": "http://merchantsite.com/success_page"
}

{
    "id": "D-4-7e27ab45-e500-4771-bd91-ba767e31b250",
    "amount": 4,
    "currency": "BRL",
    "payment_method_id": "PQ",
    "payment_method_type": "TICKET",
    "payment_method_flow": "DIRECT",
    "country": "BR",
    "bank_transfer": {},
    "ticket": {
        "type": "CUSTOM",
        "number": "00020101021226990014br.gov.bcb.pix2577pix.bpp.com.br/25021356/qrs1/v2/cobv/01aP5TN8sfPrDKBVWqCXuxWYyHrsbTvNyrlISY7R52040000530398654044.005802BR5906DLOCAL6009SAO PAULO62070503***6304FFC6",
        "expiration_date": "2022-09-24T15:35:32.486+0000",
        "id": "QRS1TXKSHZHFYC4Q3INRRWYISVX6BMSZTK1",
        "barcode": "iVBORw0KGgoAAAANSUhEUgAAAfQAAAH0CAIAAABEtEjdAABeQUlzx/0/rg/z/P8Qe+P+/M8zx/0PxhLim4LHydLAAAAAElFTkSuQmCC",
        "company_name": "",
        "provider_name": "pix",
        "provider_logo": "https://static.dlocal.com/images/providers/pix.jpg",
        "image_url": "https://pay.dlocal.com/gmf-apm/payments/M-1c7fafd3-64f0-4314-8d14-eb9ce2f5b4f9",
        "amount": 4,
        "currency": "BRL"
    },
    "created_date": "2022-09-20T15:35:31.000+0000",
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "status_code": "100",
    "order_id": "410ca991-dcfa-4306-a861-69807254737d",
    "notification_url": "http://conductor.sandbox.internal/robot-server/rest/generic/notification/new"
}

Example ticket

PIX UI built with the information in the example above.

User Interface Tips UI

If you are using this payment method through a DIRECT integration, follow the tips below in order to make it easier for your customers to complete payments, boosting your conversion rates.

Element	Tip
Currency and Amount	Should be relevant elements in the ticket. Users need to have that information very clearly.
Currency Symbol	R$
Expiration date	Display this element clearly and visible enough. In Brazil, the date format is DD/MM/YYYY.
QR Code	Present users with both payment options: QR code or Copy&Paste ID. A) Your desktop/laptop users will definitely prefer to pay by scanning the QR, since it is easy to scan a QR presented on a laptop, using their phones. B) Your mobile users, on the other hand, should probably prefer the Copy&Paste ID functionality, since the QR code is difficult to read with the very same phone that shows the QR code.
QR Code format	Base 64

Mercado Pago

Mercado Pago is a very popular wallet in several countries in Latin America which allow its users to make one-shot payments; as well as recurring payments just by authorizing the merchant on the enrollment payment.

Capabilities

	Mercado Pago
Min. amount	1 BRL
Max. expiration time supported	5 minutes (authentication)
Notification delay	Immediate
Refunds	Yes
Flow	`DIRECT` `REDIRECT`

UX Flow

One-shot payment

Tokenized wallet

How to process Mercado Pago payments?

Learn how to process with wallets (one-shot payments and wallet tokenization) with dLocal in our Wallets Payment section.

PicPay

With over 60 million users, PicPay has made its way to stand alongside other leading wallets like PayPal and Mercado Pago.

PicPay is a digital wallet app, and the country’s largest payments app, that enables users to send and receive money, pay bills, store loyalty cards and discount coupons, and more.

Capabilities

	PicPay
Min. amount	1 BRL
Max. expiration time supported	1 day
Notification delay	Immediate
Refunds	Yes
Flow	`REDIRECT`

UX Flow

The screenshots illustrate a generic PicPay redirect flow through a QR Code.

Request parameters

Property	Type	Description	Mandatory?
`amount`	Number	Amount to be charged.	Yes
`currency`	String	`BRL` Transaction currency in ISO 4217.	Yes
`country`	String	`BR` Transaction country in ISO 3166.	Yes
`payment_method_id`	String	`PZ` ID of the selected payment method.	Yes
`payment_method_flow`	String	`REDIRECT`	Yes
`payer.name`	String	Name of the payer.	Yes
`payer.email`	String	Email of the payer.	Yes
`payer.document`	Number	Document of the payer.	Yes
`order_id`	Number	ID of the capture given by the merchant in their system. Think of it as an external ID of the capture.	No
`notification_url`	String	Notifications will be sent in every change of status of a payment to the `notification_url` specified by the merchant.	No

Examples

{
    "amount": 15,
    "currency": "BRL",
    "country": "BR",
    "payment_method_id": "PZ",
    "payment_method_flow": "REDIRECT",
    "payer": {
        "name": "Pedro Gomes",
        "email": "[email protected]",
        "document": "09996352986"
    },
    "order_id": "34545sk3483kqw0",
    "description": "Tshirt",
    "notification_url": "http://merchantsite.com/notification/new",
    "callback_url": "http://merchantsite.com/success_page"
}

{
    "id": "R-4-90fb1e4f-cda4-io98-81a3-b85cb8ae9954",
    "amount": 15,
    "currency": "BRL",
    "payment_method_id": "PZ",
    "payment_method_type": "TICKET",
    "payment_method_flow": "REDIRECT",
    "country": "BR",
    "created_date": "2023-02-16T14:22:50.000+0000",
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "status_code": "100",
    "order_id": "34545sk3483kqw0",
    "description": "Tshirt",
    "notification_url": "http://merchantsite.com/notification/new",
    "redirect_url": "https://pay.dlocal.com/gmf-apm/payments-redirect/M-fd77f5b7-ca28-7u54-9ed8-ef89d374a80c"
}