Enable Google Pay

This topic gives step-by-step instructions to integrate Google Pay with the In-App Payments SDK on an Android device.

To enable Google Pay with the In-App Payments SDK on Android, the following must be true:

• You're a US, Canadian, UK, or AU Square seller. Google Pay for the In-App Payments SDK is only available for Square sellers based in the United States, Canada, the United Kingdom, or Australia.

• You've followed the instructions in Build on Android. This topic doesn't cover the general setup of the In-App Payments SDK.

• You've read, and adhere to, Google Pay API Terms of Service, Google Pay API Acceptable Use Policy, and Google's brand guidelines.

• The Google Pay application must be installed on the Android devices that your application is distributed to.

• The device user must have added a Square-supported payment method to Google Pay.

1. Add the Google Pay binary dependency to the build.gradle file of your :app module.
2. Update your AndroidManifest.xml file to include the following <meta-data/> element:

app dependency

dependencies {
...
 implementation 'com.squareup.sdk.in-app-payments:google-pay:1.5.5'
 implementation 'com.google.android.gms:play-services-wallet:16.0.0'
...
}

AndroidManifest.xml

<application
  ...
  android:theme="@style/AppTheme">
...
  <meta-data
    android:name="com.google.android.gms.wallet.api.enabled"
    android:value="true" />
...
</application>

Add a clickable item to your activity layout for starting a Google Pay payment. In step 4, add an onClickListener callback to this control.

1. Declare the following fields as private Activity variables:

     private static final String LOCATION_ID = "LOCATION_ID";
     private static final int LOAD_PAYMENT_DATA_REQUEST_CODE = 1;
     private PaymentsClient paymentsClient;
     private Button googlePayButton;

2. Copy a location ID from your application Locations page in the Developer Dashboard.

   Important

   To test an application in the Square Sandbox, set the Developer Dashboard application page to Sandbox mode and configure the SDK with a Sandbox application ID before completing the following instructions in this step.

3. Paste your Sandbox location ID to replace the placeholder "LOCATION_ID" as the value of LOCATION_ID.

1. Create a Google Pay payments client that is configured for a test environment. For more information about creating a client, see Google Pay tutorial.

    paymentsClient = Wallet.getPaymentsClient(
      this,
      new Wallet.WalletOptions.Builder().setEnvironment(
            WalletConstants.ENVIRONMENT_TEST
          ).build()
    );

2. Set the Google Pay button onClickListener.

   Replace YOUR_ACTIVITY_CLASS_NAME with the type name of your activity and the YOUR_LOCATION_ID string in the example code with a valid Square location ID. The available location IDs for a Square account can be found on the Locations page of the Square Developer Dashboard.

   googlePayButton = yourActivityView.findViewById(R.id.pay_with_google_button);
   googlePayButton.setOnClickListener(
     (view) -> {
       googlePayButton.setEnabled(false);
       AutoResolveHelper.resolveTask(
         paymentsClient.loadPaymentData(
           GooglePay.createPaymentDataRequest(
             LOCATION_ID,
             TransactionInfo.newBuilder().setTotalPriceStatus(
               WalletConstants.TOTAL_PRICE_STATUS_NOT_CURRENTLY_KNOWN
             ).setCurrencyCode( "USD" ).build()
           )
         ),
         (YOUR_ACTIVITY_CLASS_NAME) view.getContext(),
         LOAD_PAYMENT_DATA_REQUEST_CODE
       );
     }
   );

3. Request the "ready to pay" status and enable the Google Pay button if you're ready to pay. For more information about getting the pay status, see Google Pay tutorial.

   paymentsClient.isReadyToPay( GooglePay.createIsReadyToPayRequest() )
     .addOnCompleteListener(
       this,
       (task) -> googlePayButton.setEnabled(task.isSuccessful())
     );

To test your Google Pay integration, you must register a valid credit card in Google Pay.

When your Google Pay integration has passed your test procedures and you're ready to distribute your application in a production environment, complete the following tasks:

1. Complete the Google Pay Integration Checklist. If you've integrated Google Pay as described in the setup guide, the exit criteria for basics and branding testing checklist items are met. The exit criteria for Functional testing checklist items 4–9 can only be met by your application logic.

2. Complete a Google Pay API Production Access Enablement Request Form:

   • The Tokenization Method must be gateway.
   • The Payment Processor or Gateway form field must contain square.

3. Replace your step 3 Sandbox application ID and location ID with production values.

4. Set the client environment to production by using WalletConstants.ENVIRONMENT_PRODUCTION.

   paymentsClient = Wallet.getPaymentsClient(
     this,
     new Wallet.WalletOptions.Builder()
         .setEnvironment(WalletConstants.ENVIRONMENT_PRODUCTION)
   .build());

To add security to a payment method, you can add the 3D Secure security protocol layer to the application. 3D Secure integrates Strong Customer Authentication (SCA) to verify the identity of the payment card holder by using the verifyBuyer function. For more information, see 3D Secure Overview.