Apple Pay & Google Pay

Before integrating, please review the API Description and Common Rules.

Both Apple Pay and Google Pay can be integrated via Checkout Mode (payUrl redirect) or Component Mode (clientToken embed), supporting one-time collection (CIT), MIT charges, and fixed-term subscriptions.

Device & Browser Requirements

If the Apple Pay or Google Pay button does not appear on your checkout page or component, verify your device, OS, and browser settings against the checklist below:

Apple Pay Requirements
Google Pay Requirements

Device & Wallet Checklist

At least one supported card must be added to Apple Wallet on the device.
Must use a compatible Apple Pay device that supports biometric authentication (Face ID / Touch ID).
Must be served over HTTPS in a supported Safari browser.
Allow Safari to check for Apple Pay: Settings > Advanced > Allow Websites to Check for Apple Pay and Apple Card.
Do not use Safari Private Browsing windows.
Confirm the device is operating in one of the supported countries and regions.

Supported Browsers

Desktop: macOS Safari 10.1+
Mobile: iOS Safari 9+, as well as other browsers using the system-provided WebKit engine

General Requirements: Browsers not explicitly listed above must support TLS 1.2+ and native JavaScript Promises.

Regional Availability

Apple Pay and Google Pay are available across 62 countries and regions. Check the Supported & Unsupported Regions List to confirm availability in your target market.

Payment Codes, Limits & Special Rules

Currency	Payment Type (`payType`)	Payment Code (`inBankCode`)	Single Limit (USD)	Status	Description
USD	`EWALLET`	`APPLE_PAY`	0.99 - 1000	Available	Apple Pay
USD	`EWALLET`	`GOOGLE_PAY`	0.99 - 1000	Available	Google Pay

Mutual Exclusivity between inBankCode and paymentMethods:
- To launch a single wallet, pass payType: "EWALLET" and inBankCode: "APPLE_PAY" (or "GOOGLE_PAY"), leaving paymentMethods empty.
- To display wallets alongside credit cards in a custom top-to-bottom order, pass paymentMethods (e.g., "GOOGLE_PAY,APPLE_PAY,CREDIT_CARD"), leaving inBankCode empty.
Apple Pay Weekly Subscription Limitation: In Subscription Apply (/subscription/apply), Apple Pay does not support the weekly interval code W. For weekly Apple Pay subscriptions, use the daily interval recurringInterval: "D" with recurringIntervalCount: 7.

Core APIs & Request Examples

Mobile wallets share the same collection, MIT, subscription, and refund endpoints as credit cards:

Collection Apply (/usd/collect/apply)

Create a one-time Apple Pay or Google Pay order, returning both payUrl and clientToken.

MIT Collection Apply (/usd/mit/apply)

Complete initial wallet authorization and trigger subsequent off-session MIT charges.

Subscription Apply (/subscription/apply)

Create a fixed-term recurring subscription order.

Order Query & Refund

Query final order status (/usd/collect/query) or initiate full/partial refunds (/usd/refund/apply).

Request Examples (`/usd/collect/apply`)

Apple Pay Single Method
Google Pay Single Method

{
  "appId": 1054,
  "orderId": "M233323000061",
  "amount": "299.99",
  "phone": "+12025551234",
  "email": "robert.taylor@gmail.com",
  "name": "Robert Taylor",
  "payType": "EWALLET",
  "inBankCode": "APPLE_PAY",
  "callBackUrl": "https://merchant.com/payment/success",
  "callBackFailUrl": "https://merchant.com/payment/fail",
  "cancelUrl": "https://merchant.com/payment/cancel",
  "notifyUrl": "https://merchant.com/api/notify",
  "subject": "Apple Pay Order",
  "partnerUserId": "149597870",
  "sign": "af0gAHkUOyYHu9owQp8NJ4mPEeUW4vuJcjdxqLIzrVw8AvpLSjD1DXupReSG..."
}

{
  "appId": 1054,
  "orderId": "M233323000062",
  "amount": "299.99",
  "phone": "+12025551234",
  "email": "robert.taylor@gmail.com",
  "name": "Robert Taylor",
  "payType": "EWALLET",
  "inBankCode": "GOOGLE_PAY",
  "callBackUrl": "https://merchant.com/payment/success",
  "callBackFailUrl": "https://merchant.com/payment/fail",
  "cancelUrl": "https://merchant.com/payment/cancel",
  "notifyUrl": "https://merchant.com/api/notify",
  "subject": "Google Pay Order",
  "partnerUserId": "149597870",
  "sign": "af0gAHkUOyYHu9owQp8NJ4mPEeUW4vuJcjdxqLIzrVw8AvpLSjD1DXupReSG..."
}

Quick start

Merchant Guide

Common Payment

Global Payment

Unified API

End To End Testing

Appendix

Merchant FAQ

Apple Pay & Google Pay

Device & Browser Requirements

Regional Availability

Payment Codes, Limits & Special Rules

Core APIs & Request Examples

Collection Apply (/usd/collect/apply)

MIT Collection Apply (/usd/mit/apply)

Subscription Apply (/subscription/apply)

Order Query & Refund

Request Examples (`/usd/collect/apply`)

​Device & Browser Requirements

​Regional Availability

​Payment Codes, Limits & Special Rules

​Core APIs & Request Examples

Collection Apply (/usd/collect/apply)

MIT Collection Apply (/usd/mit/apply)

Subscription Apply (/subscription/apply)

Order Query & Refund

​Request Examples (/usd/collect/apply)

​Related Topics

Device & Browser Requirements

Regional Availability

Payment Codes, Limits & Special Rules

Core APIs & Request Examples

Request Examples (`/usd/collect/apply`)

Related Topics