Client-Side Implementation

Android v4SDK

• Current Braintree SDKs
• Android v5
• iOS v6
• JavaScript v3
• Previous Versions
• Android v4
• iOS v5
• JavaScript v2

important

The SSL certificates for all Braintree SDKs are set to expire by June 30, 2025. This will impact existing versions of the SDK in published versions of your app. To reduce the impact, upgrade the Android SDK to version 4.45.0+ or version 5.0.0+ for the new SSL certifications.

If you do not decommission your app versions that include the older SDK versions or force upgrade your app with the updated certificates by the expiration date, 100% of your customer traffic will fail.

Choose an integration method

You can accept Google Pay with either our Drop-in UI or a custom integration.

Drop-in integration

Our Drop-in UI is the fastest way to set up your client-side integration.

For full details, see Drop-in Setup and Integration.

Custom integration

Add the following in your app-level build.gradle:

dependencies {
    implementation("com.braintreepayments.api:google-pay:4.49.1")
}

Initialization

First, create a BraintreeClient with a ClientTokenProvider or Tokenization Key. Then construct a GooglePayClient.

Before showing the Google Pay button, use the GooglePayClient#isReadyToPay method to check whether the user's current device is compatible. When the result is true, show the Google Pay button. When the result is false, display other checkout options.

braintreeClient = BraintreeClient(this, ExampleClientTokenProvider())
googlePayClient = GooglePayClient(this, braintreeClient)
googlePayClient.isReadyToPay(this) { isReadyToPay, error -> 
  if (isReadyToPay) {
    // show Google Pay button
  }
}

You will need a button element on your page styled according to Google's brand guidelines.

The CARD payment method type is supplied by the Braintree Android SDK as an allowed payment method when making the IsReadyToPayRequest. It also provides the PAYPAL payment method type if you are using Google Pay v2 and currently accept PayPal payments. If you desire different behavior for the IsReadyToPayRequest, you can follow Google's documentation and make the IsReadyToPayRequest outside of the Braintree Android SDK.

Requesting a payment

Google Pay requires a price to be specified using the 'TransactionInfo' object. Build a 'TransactionInfo' object and provide it at the time of payment, along with your Google-provided googleMerchantId for production transactions.

Implement a GooglePayListener to receive results, and call 'requestPayment' to invoke the payment flow.

public class MyActivity extends AppCompatActivity implements GooglePayListener {
  
  private BraintreeClient braintreeClient;
  private GooglePayClient googlePayClient;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    braintreeClient = new BraintreeClient(this, new ExampleClientTokenProvider());
    googlePayClient = new GooglePayClient(this, braintreeClient);
    googlePayClient.setListener(this);
  }

  public void onGooglePayButtonClick(View view) {
    GooglePayRequest googlePayRequest = new GooglePayRequest();
    googlePayRequest.setTransactionInfo(TransactionInfo.newBuilder()
        .setTotalPrice("1.00")
        .setTotalPriceStatus(WalletConstants.TOTAL_PRICE_STATUS_FINAL)
        .setCurrencyCode("USD")
        .build());
    googlePayRequest.setBillingAddressRequired(true);

    googlePayClient.requestPayment(this, googlePayRequest);
  }

  @Override
  public void onGooglePaySuccess(@NonNull PaymentMethodNonce paymentMethodNonce) {
      // send paymentMethodNonce.getString() to server
  }

  @Override
  public void onGooglePayFailure(@NonNull Exception error) {
    if (error instanceof UserCanceledException) {
      // user canceled
    } else {
      // handle error
    }
  }
}