Google Pay™
Google Pay is a convenient payment system which allows customers to make payments in your app or website using any credit or debit card saved to their Google Account.
Since Google devices are widely used in the countries where dLocal operates, supporting Google Pay in your app can help simplify the checkout process and increase conversions, as payment details are recovered from the customers' Google Accounts whenever they have previously saved or used their credit or debit cards with Google Pay.
As of Jan 2020, Google Pay is supported in the following countries: Argentina, Brazil, Chile, Colombia, Egypt, India, Indonesia, Mexico, Peru, Uruguay
For a more up to date list, please see:
For details on the card networks supported, please see the Payment Methods section.

Payment flow

  1. 1.
    The customer clicks on the Google Pay button in the merchant's client, whether it is an online store or app. The merchant initiates the Google Pay request using the Google Pay Web API or Android SDK.
  2. 2.
    After the customer selects his payment method or provides his payment details, Google replies with a token.
  3. 3.
    The merchant's client submits this information to the merchant's backend.
  4. 4.
    In the payment request to dLocal, the merchant includes the token received in step 2.
  5. 5.
    dLocal processes the payment using the Google Pay token and returns the payment confirmation to the merchant.
  6. 6.
    The merchant then notifies the customer that the payment has been successful.


Supporting Google Pay requires following these two steps:

Step 1 - Google Integration (Frontend)

When performing this step use the following parameters:
  • gatewayMerchantId – You can obtain this value from your TAM
  • gateway - use dlocal as the parameter value
  • Required fields: Name, address, phone, and email
Required document information
Please remember to also request the user's personal ID document before or after the user clicks on the Google Pay button and sending it to dLocal in the payer object, as this is a requirement for payment.
Supported Payment Methods
For supported payment type, select CARD. The following card networks are currently supported:
  • VISA
  • AMEX
  • JCB (Only for Brazil)
  • ELO (Only for Brazil)
  • ELO_DEBIT (Only for Brazil)
For supported authentication methods usePAN_ONLY

Step 2 - dLocal Integration (Backend)

You will need to submit a standard payment request via the endpoint using the following parameter values:
  • payment_method_id should be CARD
  • card.gpay_token should be the json obtained in the Google Integration step. It is important to send a json object and not a string in this parameter.
Example Payment Request
Example Payment response

Example Request body

"amount": 120.00,
"currency" : "BRL",
"country": "BR",
"payment_method_id" : "CARD",
"payment_method_flow" : "DIRECT",
"document" : "53033315550",
"name": "Ricardo Gomes"
"gpay_token": {
"signature": "MEQCIBllBeoYFjIvIjPZmYG..."
"order_id": "657434343",
"notification_url": ""

Example Payment response

"id": "D-4-cf8eef6b-52d5-4320-b5ea-f5e0bbe4343f",
"amount": 120.00,
"currency": "BRL",
"payment_method_id": "CARD",
"payment_method_type": "CARD",
"payment_method_flow": "DIRECT",
"country": "BR",
"card": {
"holder_name": "Ricardo Gomes",
"expiration_month": 12,
"expiration_year": 2025,
"brand": "VI",
"last_4": "1111"
"created_date": "2018-12-26T20:26:09.000+0000",
"approved_date": "2018-12-26T20:26:09.000+0000",
"status": "PAID",
"status_detail": "The payment was paid",
"status_code": "200",
"order_id": "657434343",
"notification_url": ""

Getting ready to go live

After you have completed all the necessary steps of the integration process in the testing environment, please make sure you have requested Google Production Access, as detailed in the Google Web and Android documentation, and have updated your Google integration configuration (Step 1) for Production environment access. Finally, make sure you have contacted your Technical Account Manager so that we can help check everything has been correctly configured and confirm you are ready to go live.
New documentation site
This documentation is now hosted on a new site that is easier to navigate, contribute to, get started with, and overall a big improvement for the experience.
The site you are currently in will soon be deprecated but everything you need is available on the new site.
Copy link
On this page
Payment flow
Step 1 - Google Integration (Frontend)
Step 2 - dLocal Integration (Backend)
Getting ready to go live