v2.1
Solutions
Products
GUIDES
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
Payment flow
- 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.After the customer selects his payment method or provides his payment details, Google replies with a token.
- 3.The merchant's client submits this information to the merchant's backend.
- 4.In the payment request to dLocal, the merchant includes the token received in step 2.
- 5.dLocal processes the payment using the Google Pay token and returns the payment confirmation to the merchant.
- 6.The merchant then notifies the customer that the payment has been successful.
Integration
Supporting Google Pay requires following these two steps:
Step 1 - Google Integration (Frontend)
- For Web integration, please see the Google Pay / Web documentation, along with the Web integration checklist and Web brand guidelines.
- For Android / SDK integration, please see the Google Pay / Android documentation, along with the Android integration checklist and Android brand guidelines.
When performing this step use the following parameters:
gatewayMerchantId– You can obtain this value from your TAMgateway- usedlocalas 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
- ELECTRON
- MASTERCARD
- MAESTRO
- AMEX
- DISCOVER
- JCB (Only for Brazil)
- ELO (Only for Brazil)
- ELO_DEBIT (Only for Brazil)
For supported authentication methods use
PAN_ONLYStep 2 - dLocal Integration (Backend)
You will need to submit a standard payment request via the https://api.dlocal.com/secure_payments endpoint using the following parameter values:
payment_method_idshould beCARDcard.gpay_tokenshould 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
1
{
2
"amount": 120.00,
3
"currency" : "BRL",
4
"country": "BR",
5
"payment_method_id" : "CARD",
6
"payment_method_flow" : "DIRECT",
7
"payer":{
8
"document" : "53033315550",
9
"name": "Ricardo Gomes"
10
},
11
"card":{
12
"gpay_token": {
13
"signature": "MEQCIBllBeoYFjIvIjPZmYG..."
14
}
15
},
16
"order_id": "657434343",
17
"notification_url": "http://merchant.com/notifications"
18
}
Copied!
Example Payment response
1
{
2
"id": "D-4-cf8eef6b-52d5-4320-b5ea-f5e0bbe4343f",
3
"amount": 120.00,
4
"currency": "BRL",
5
"payment_method_id": "CARD",
6
"payment_method_type": "CARD",
7
"payment_method_flow": "DIRECT",
8
"country": "BR",
9
"card": {
10
"holder_name": "Ricardo Gomes",
11
"expiration_month": 12,
12
"expiration_year": 2025,
13
"brand": "VI",
14
"last_4": "1111"
15
},
16
"created_date": "2018-12-26T20:26:09.000+0000",
17
"approved_date": "2018-12-26T20:26:09.000+0000",
18
"status": "PAID",
19
"status_detail": "The payment was paid",
20
"status_code": "200",
21
"order_id": "657434343",
22
"notification_url": "http://merchant.com/notifications"
23
}
Copied!
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.
Last modified 11mo ago