PIX Payments

OUR SOLUTION COUNTRIES CUSTOMERS CONTACT US
Search…
PIX Payments
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).
PIX payment method is only available in Brazil
PIX payments support a REDIRECT or DIRECT flow.
Redirect PIX Payment
In this flow, payment_method_flow is set to REDIRECT . The API returns a redirect_URL, which is used to redirect the user to a dLocal-hosted page (shown below). The user will be able to open any App that supports PIX (Home Banking and Ewallets) and decide whether to use the scan QR or the Transaction ID copy/paste option.
Using the REDIRECT method, the payment will have the PENDING status until the user confirms the payment, and dLocal gets notified (immediate after user confirmation).
PIX redirect display example
Example Request
Example Response
Example request body
1
{
2
    "amount": 100,
3
    "currency": "BRL",
4
    "country": "BR",
5
    "payment_method_id": "PQ",
6
    "payment_method_flow": "REDIRECT",
7
    "payer": {
8
        "name": "Thiago Gabriel",
9
        "email": "[email protected]",
10
        "document": "53033315550"
11
    },
12
    "order_id": "5346523564",
13
    "notification_url": "http://merchant.com/notifications"
14
}
Copied!
​
1
{
2
    "id": "D-4-75c7473a-ab86-4e43-bd39-c840268747d3",
3
    "amount": 100,
4
    "currency": "BRL",
5
    "payment_method_id": "PQ",
6
    "payment_method_type": "TICKET",
7
    "payment_method_flow": "REDIRECT",
8
    "country": "BR",
9
    "created_date": "2020-11-16T20:37:20.000+0000",
10
    "status": "PENDING",
11
    "status_detail": "The payment is pending",
12
    "status_code": "100",
13
    "order_id": "5346523564",
14
    "notification_url": "http://merchant.com/notifications",
15
    "redirect_url": "https://dlocal.com/collect/pay/pay/M-0aa0cc00-094e-11e9-9f92-dbdad3ad0963?xtid=CATH-ST-1545856640-602791137"
16
}
Copied!
Direct PIX Payment
PIX payments are available via our Direct APMs solution (payment_method_flow = DIRECT). The important parameters are returned via API, so the merchant can build their own PIX UI.
Using the DIRECT method, the payment will have the PENDING status until the user confirms the payment, and dLocal gets notified (immediate after user confirmation).
Example Request
Example Response
1
{
2
    "amount": 100,
3
    "currency": "BRL",
4
    "country": "BR",
5
    "payment_method_id": "PQ",
6
    "payment_method_flow": "DIRECT",
7
    "payer": {
8
        "name": "Thiago Gabriel",
9
        "email": "[email protected]",
10
        "document": "53033315550"
11
    },
12
    "order_id": "5346523564",
13
    "notification_url": "http://merchant.com/notifications"
14
}
Copied!
​
1
{
2
    "id": "D-4-75c7473a-ab86-4e43-bd39-c840268747d3",
3
    "amount": 100,
4
    "currency": "BRL",
5
    "payment_method_id": "PQ",
6
    "payment_method_type": "TICKET",
7
    "payment_method_flow": "DIRECT",
8
    "country": "BR",
9
    "ticket": {
10
        "type": "CUSTOM",
11
        "number": "QRS2-BTCN44FJ6HDQLB0DKKN2",
12
        "expiration_date": "2020-11-22T01:59:00.000+0000",
13
        "id": "QRS2-BTCN44FJ6HDQLB0DKKN2",
14
        "barcode": "iVBORw0KGgoAAAANSUhEUgAAAfQAAAH0CAIAAABEtEjdAABdsUlEQVR4XuzUwYolSbZs2/P/P/s",
15
        "company_name": "DLOCAL BRASIL LTDA",
16
        "provider_name": "pix",
17
        "provider_logo": "http://static-sandbox.dlocal.com/images/providers/pix.png",
18
        "image_url": "http://backoffice.dlocal.sandbox/gmf/payments/M-146aa2f0-094f-11e9-9f92-dbdad3ad0963"
19
    },
20
    "created_date": "2020-11-16T20:37:20.000+0000",
21
    "status": "PENDING",
22
    "status_detail": "The payment is pending",
23
    "status_code": "100",
24
    "order_id": "5346523564",
25
    "notification_url": "http://merchant.com/notifications"
26
}
Copied!
Specific instructions:
Mobile version instructions (Direct flow):
Copy and paste flow
1.As users who are paying using PIX with their mobile device will not be able to scan the QR code, the mobile flow is based on copying and pasting the ticket.number to the Bank Application in order to complete the payment.
2.Please use ticket.number for the Copy and Paste experience, the label presented to the user should be '"Copia e Cola" (The local and known term).
Desktop version instructions 
Adding a QR code to the PIX payment page (Direct flow)
There are 2 ways of presenting the QR code to the user:
1.Build a QR code using the ticket.number field
2.Use the ticket.barcode field - It includes a Base64 encoded QR image.
​
Retry Payments
PIX Merchant API
Last modified 1yr ago
Copy link
Contents
Redirect PIX Payment
Direct PIX Payment
Specific instructions: