Google Pay on Android

This page covers adding Google Pay to a native Android app. For web integrations, see Google Pay with Elements or Set up Google Pay (API).

How it worksAskCopy

In a native Android app, Google Pay is presented through the Google Pay API for Android. The customer taps the button, authenticates with their device biometrics or PIN in the Google Pay sheet, and Google returns an encrypted payment token. VINR decrypts the token, runs the appropriate authentication handling, and processes the payment.

The VINR Android SDK wraps the Google Pay API, handling button rendering, eligibility checks, and token submission so you work with a single SDK surface.

PrerequisitesAskCopy

• Google Pay enabled on your VINR account (Settings → Payment methods).
• Android app targeting API level 19 (Android 4.4) or above.
• Google Play Services installed on the target device (required for Google Pay).

InstallationAskCopy

Add the VINR Android SDK to your build.gradle:

dependencies {
    implementation 'com.vinr:vinr-android-sdk:1.0.0'
}

Also add the Google Pay dependency if not already present:

dependencies {
    implementation 'com.google.android.gms:play-services-wallet:19.4.0'
}

Enable Google Pay in your AndroidManifest.xml:

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

Initialize the VINR SDKAskCopy

Initialize VINR in your Application class with your publishable key:

import com.vinr.android.VinrSDK

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        VinrSDK.initialize(
            context = this,
            publishableKey = "pk_live_..."  // use pk_test_... for sandbox
        )
    }
}

Check eligibilityAskCopy

Always check whether Google Pay is available on the device before showing the button. VINR provides a helper that calls isReadyToPay against the Google Pay API with your merchant account configuration.

import com.vinr.android.googlepay.VinrGooglePayLauncher

val googlePayLauncher = VinrGooglePayLauncher(
    activity = this,
    config = VinrGooglePayLauncher.Config(
        environment = VinrGooglePayLauncher.Environment.Production,  // .Test for sandbox
        merchantCountryCode = "BG",
        merchantName = "Your Business Name",
    ),
    readyCallback = { isReady ->
        googlePayButton.isVisible = isReady
    },
    resultCallback = ::onGooglePayResult,
)

The readyCallback fires after the SDK calls isReadyToPay. Show the button only when isReady is true — do not show a disabled button.

Add the Google Pay buttonAskCopy

Use only the official Google Pay button from the Pay Button API or VINR's pre-built button component. Do not create a custom image or custom view as a substitute.

<!-- layout/activity_checkout.xml -->
<com.vinr.android.ui.GooglePayButton
    android:id="@+id/googlePayButton"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:visibility="gone"
    app:buttonType="buy"
    app:buttonTheme="dark" />

Available buttonType values: buy, pay, checkout, subscribe, donate, book, order, plain.

Present the Google Pay sheetAskCopy

Call present() from inside the button's click handler. Do not call it inside a coroutine or after an async operation — it must be called synchronously from the click event to avoid the Android pop-up blocker equivalent.

googlePayButton.setOnClickListener {
    // Create a PaymentIntent or retrieve clientSecret from your server first
    googlePayLauncher.present(clientSecret = "pi_..._secret_...")
}

VINR creates the Google Pay payment sheet using your merchant account configuration (allowedAuthMethods, allowedCardNetworks). The customer selects a card, authenticates, and VINR submits the token.

Handle the resultAskCopy

Implement the resultCallback to handle the outcome:

private fun onGooglePayResult(result: VinrGooglePayLauncher.Result) {
    when (result) {
        is VinrGooglePayLauncher.Result.Completed -> {
            // Payment succeeded — trigger fulfillment from the payment.completed webhook,
            // not from this callback alone (browser/app may close before webhook fires)
            showOrderConfirmation()
        }
        is VinrGooglePayLauncher.Result.Failed -> {
            // Payment declined or error
            showError(result.error.localizedMessage)
        }
        VinrGooglePayLauncher.Result.Canceled -> {
            // Customer dismissed the sheet — do not show an error
            // Allow the customer to retry or choose another payment method
        }
    }
}

PAN_ONLY and 3D SecureAskCopy

VINR handles PAN_ONLY credential step-up automatically on Android. If the payment requires a 3D Secure challenge, the SDK presents the challenge UI inside the app without any additional code on your side. Handle the result the same way regardless of credential type.

See Authentication methods for the difference between CRYPTOGRAM_3DS and PAN_ONLY.

TestingAskCopy

Set VinrGooglePayLauncher.Environment.Test and use your sandbox publishable key (pk_test_...). In test mode:

• isReadyToPay returns true regardless of enrolled cards.
• No real card is charged.
• Google provides a test card suite — see Google's Android test card instructions.

Test both CRYPTOGRAM_3DS and PAN_ONLY scenarios before going live. See Test & go live for the full scenario reference.

Going liveAskCopy

Work through the Go-live checklist before releasing to production. Key Android-specific items:

• Switch to VinrGooglePayLauncher.Environment.Production and your live publishable key.
• Confirm with your VINR account manager that your account is approved for live payments.
• Test an end-to-end live transaction on a real device before release.

See alsoAskCopy