Google Pay ™

Google Pay is a e-wallet. It allows shoppers to make payments in e-commerce stores and apps using their credit and debit cards stored in their Google Account and Android devices in a safe and easy way.

Requirements

1. Agree to Google’s terms of service
2. Integrate Google Pay into your app (https://developers.google.com/pay/api/android/overview)
3. Contrat the Cielo 3.0 as payment acquier
4. Integrate Cielo 3.0 API REST (https://developercielo.github.io/manual/cielo-ecommerce)

Step 1: Integrating Google Pay into you Android app

Action 1 - Configure your project

https://developers.google.com/pay/api/android/guides/setup

In these steps, the following points should be observed:

• Project Configuration
• Modify your Manifest

Action 2 - Google Pay Implementation

To integrate Google Play into your app, follow all the steps in the Google Pay documentation:

https://developers.google.com/pay/api/android/guides/tutorial

For the correct integration of Google Play using Cielo’s payment API, it is necessary to observe the following points:

Gateway Definition

In the “Step 2: Choose a payment tokenization method”, follow the “GATEWAY” integration model and send the “type” as “ PAYMENT_GATEWAY” and “ gateway” as “ cielo”, according to the example:

private static JSONObject getTokenizationSpecification() {
  JSONObject tokenizationSpecification = new JSONObject();
  tokenizationSpecification.put("type", "PAYMENT_GATEWAY");
  tokenizationSpecification.put(
      "parameters",
      new JSONObject()
          .put("gateway", "cielo")
          .put("gatewayMerchantId", "MerchantId"));
  return tokenizationSpecification;
}

To the field “ gatewayMerchantId”, send your merchant identification provided by Cielo. The merchant identification is formated as XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX (i.e. GUID(36)).

Definition of brands

In the “Step 3: Define supported payment card networks”, use these brands: “VISA”, “MASTERCARD”, “AMEX”, “DISCOVER” E “JCB”

Definition of environment

In the “Step 5: Create a PaymentsClient instance”, use the vaue “WalletConstants.ENVIRONMENT_TEST” for test purpose.

Definition of shopping data

In the “Step 7: Create a PaymentDataRequest object”, use the value “BRL” for “ currencyCode”. The field “ merchantName” is the name that shopper will see during Google Pay payment process, then, the recomendation is the use of friendly name.

Payment Data Recovery

In the “Step 9: Handle the response object”, the “Activity.RESULT_OK” event is described, which is returned a object with all the payment data, including payment tokens.

The PaymentData contains the object PaymentMethodToken. To get this object, use the getPaymentMethodToken() method.

(to see more details: https://developers.google.com/android/reference/com/google/android/gms/wallet/PaymentData)

After getting the PaymentMethodToken, you shold get the string that contains the payment tokens. To get the string, use the GetToken() method from PaymentMethodToken object.

(to see more details: https://developers.google.com/android/reference/com/google/android/gms/wallet/PaymentMethodToken)

The string obtained will be similar as follows:

{
  "protocolVersion": "ECv1",
  "signature": "TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ",
  "signedMessage": "{\"encryptedMessage\":
  \"ZW5jcnlwdGVkTWVzc2FnZQ==\",\"ephemeralPublicKey\":
  \"ZXBoZW1lcmFsUHVibGljS2V5\",\"tag\": \"c2lnbmF0dXJl\"}"
}

(to see more details: https://developers.google.com/pay/api/android/guides/resources/payment-data-cryptography)

Keep the values “signedMessage” and “signature”. They will be requested in the Cielo’s authorization process in the next step (Step 2: Authorization with Google Pay)

Step 2: Authorization with Google Pay

The authorization with the Google Pay token must be performed as the same way as a standard authorization for a credit card, but providing token in place of the open card data, as following example:

Request

{
  "MerchantOrderId": "2014111708",
  "Customer": {
    (…)
  },
  "Payment": {
    "Type": "CreditCard",
    "Amount": 100,
    "Installments": 1,
    "Wallet": {
      "Type": "AndroidPay",
      "WalletKey": "{\"encryptedMessage\": \"ZW5jcnlwdGVkTWVzc2FnZQ==\",\"ephemeralPublicKey\": \"ZXBoZW1lcmFsUHVibGljS2V5\",\"tag\": \"c2lnbmF0dXJl\"}",
      "AdditionalData": {
        "Signature": "ZXBoZW1lcmFsUHVibGljS2V5"
      }
    }
  }
}

For more information: https://developercielo.github.io/manual/cielo-ecommerce

Response

Vide https://developercielo.github.io/manual/cielo-ecommerce#resposta

Step 3: Requesting production access

Action 1 - Branding Guideline

Check the all the branding guidelines to help you implement Google Pay within your apps. The guideline is available at: https://developers.google.com/pay/api/android/guides/brand-guidelines

Action 2 - Checklist and Request production access

Ensure if all the checklist item was completed. When you are ready, request the production access to deploy your app in production environment. The checklist is available at: https://developers.google.com/pay/api/android/guides/test-and-deploy/integration-checklist