Developer Docs

Learn to set up and accept payments through Google Pay^TM

Merchants can now support Google Pay^TM as a payment method using XPay on their websites.

Currently, XPay supports Google Pay^TM via SDKs only, and merchants are advised to use the respective SDK to render the GPay option and then proceed with confirmPayment() SDK method as usual.

1. XPay Element

• Merchants need to use the XPay Element v4 SDK.

SDK URL

• Stage Env v4 SDK

• Live Env v4 SDK

React Package

• npm i @xstak/xpay-element-stage-v4

• npm i @xstak/xpay-element-live-v4

But first, merchants should test integration on their staging for UAT environments.

2. XPay Flutter SDK

Use the following Flutter package version to enable Google Pay^TM.

// for production
dependencies:
  xpay_element_flutter: ^3.3.0

// for stagging
dependencies:
  xpay_element_flutter_stage: ^3.6.0

3. Support for Google Pay^TM Button

Currently, XPay doesn’t support paying with the Pay with Google Pay button rendered separately. You are advised to use XPay SDKs and enable GPay as per the docs below.

4. Enabling Google Pay^TM

• Google Pay^TM will only work with the Bank Alfalah gateway at the moment. If BAFL MIDs are not added to XAP account gateways, the Google Pay^TM option won’t show.

• In the XPay staging environment, Google Pay^TM works by default.

Go-Live CheckList

• Google Pay^TM needs to be enabled on Bank Alfalah MIDs.

• The merchant website domain, including the subdomain where the XPay Element Google Pay^TM would be rendered, will need to be whitelisted by Google.

  • Merchants will need to apply here.

• To go live with Google Pay^TM on Flutter, you need to publish your app on the Google Play Store and then apply for live approval via the Google Pay^TM & Wallet Console using the same published app.

Enable Google Pay^TM on XAP

1. Go to XAP Store settings and click Edit Store Setting.

2. Add the Google Merchant ID value to the respective field.

3. From store settings on XAP, the Google Pay^TM option needs to be enabled.

5. Card Networks Supported

Currently, we support Visa, MasterCard, and AMEX.

6. Authorization Methods

We support both PAN_ONLY and CRYPTOGRAM_3DS. In case of PAN_ONLY, 3DS flow will be triggered but with CRYPTOGRAM_3DS tokenized payment will be performed.

7. Gateway & Gateway Merchant ID

XPay SDK automatically fills these values for the Google Pay IsReadyToPayRequest method. But adding further details for merchant clarification.

1. Gateway Merchant ID is the public key passed in the SDK instance.

2. Gateway value will be xpaybyxstak