XPay Go-Live Guide

Use this guide to move a tested XPay integration from staging to production. Configure your live XPay account and production environment first, then complete any provider-specific requirements that apply.

Configure XPay for production#

1. Obtain your live XPay account from your XPay onboarding contact.
2. Sign in to the XPay Admin Portal (XAP).
3. Open Settings and set the store mode to Live.
4. Generate production keys for the live account.
5. Update your integration to use the production keys, live account ID, and production API base URL.
6. In XAP, create a gateway instance and select your acquiring gateway.
7. Add the production credentials supplied by the acquiring gateway.

Configure the SDK for production#

Use the SDK for your platform and ensure that your integration uses production credentials and endpoints.

API Base URL#

https://xstak-pay.xstak.com

Web#

<script src="https://js.xstak.com/v5/xpay.js"></script>

Android#

Add the following dependency to your application-level Gradle file:

dependencies {
    implementation("com.github.XStakCommerce:XPay-Element-Android-Native-SDK:2.1.5")
}

React Native 0.76 and later#

npm install @xstak/xpay-element-react-native@7.0.0

React Native versions earlier than 0.76#

npm install @xstak/xpay-element-react-native-legacy@2.0.4

Flutter#

Add the following dependency to your pubspec.yaml file:

dependencies:
  xpay_element_flutter: ^7.0.2

Complete the payment-provider setup#

Before going live, confirm with your acquiring bank or payment service provider (PSP) that:

• Your merchant IDs (MIDs) are enabled for API-based payments.
• If you plan to tokenize payment methods, tokenization is enabled for those MIDs.
• If you plan to issue refunds through the XPay Merchant Portal, refunds are enabled for those MIDs.

Provider-specific checklists#

If your integration uses either of the following payment providers, complete the corresponding checklist in addition to the XPay go-live steps above:

Go-live checklist#

Before accepting production payments, confirm that:

• The correct live XPay account is selected.
• The store mode is set to Live.
• The production XPay keys are configured.
• The live account ID is configured.
• The production API base URL is configured.
• The appropriate SDK is configured for production.
• The acquiring gateway instance contains the correct production credentials.
• The applicable MID capabilities are enabled.
• If you use EasyPaisa or SafePay, the corresponding provider-specific checklist has been completed.