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.

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.

Step 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_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.

{
    "amount": 120.00,
    "currency" : "BRL",
    "country": "BR",
    "payment_method_id" : "CARD",
    "payment_method_flow" : "DIRECT",
    "payer":{
        "document" : "53033315550",
        "name": "Ricardo Gomes"
    },
    "card":{
         "gpay_token": {
            "signature": "MEQCIBllBeoYFjIvIjPZmYG..."
          }         
    },
    "order_id": "657434343",
    "notification_url": "http://merchant.com/notifications"
}

{
    "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": "http://merchant.com/notifications"
}

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.