Apple Pay is a that enables customers to pay using any credit or debit card saved to their Apple Wallet on iPhone, iPad, or Mac. Apple Pay provides a seamless, secure checkout experience with biometric authentication for over a billion Apple device users worldwide.
Customers authenticate with Face ID, Touch ID, or device passcode — no password or card details needed.
Card details are replaced with device-specific tokens, protecting sensitive data and reducing fraud.
Multiple integration options: Onerway SDK, hosted Checkout, or direct Apple Pay API.
Available in 70+ countries (except China) with support for major card networks.
Apple Pay is available in 70+ countries and regions across Asia-Pacific, Europe, Americas, and Middle East & Africa. Onerway merchants can accept Apple Pay payments with local currency settlement.
For the complete list, see Countries and regions that support Apple Pay.
| Field | Type | Description | Required |
|---|---|---|---|
orderAmount | string | Payment amount to be charged | ✅ |
orderCurrency | string | Transaction currency (ISO 4217) | ✅ |
productType | string | Set to CARD | ✅ |
subProductType | string | - DIRECT for one-time payments - SUBSCRIBE for recurring | ✅ |
tokenInfo | string | Apple Pay token from frontend SDK | ✅ |
billingInformation | string | Billing address information | ✅ |
shippingInformation | string | Shipping address information | ✅ |
{
"provider": "ApplePay",
"tokenId": "<APPLE_PAY_TOKEN>"
}
tokenId is the payment token obtained from the Apple Pay JavaScript SDK on your frontend. Onerway will decrypt and process the token securely.| Value | Use Case |
|---|---|
DIRECT | One-time payments |
SUBSCRIBE | Recurring / subscription payments |
subProductType to SUBSCRIBE to enable recurring billing with the tokenized card.| Type | API | User Flow |
|---|---|---|
| SDK | SDK Integration | Merchant embeds Onerway SDK → Apple Pay button |
| CHECKOUT | Checkout API | Merchant → Onerway Checkout → Apple Pay |
| DIRECT | Payment API | Merchant uses Apple Pay JS → Submit token to Onerway |
Before integrating Apple Pay, ensure you have:
The Apple Pay payment flow involves the customer selecting Apple Pay, authenticating with Face ID or Touch ID, and confirming the payment:
Apple Pay via Onerway is available on devices with Secure Element:
| Device | Authentication | Notes |
|---|---|---|
| iPhone | Face ID / Touch ID | iOS 8.1+ required |
| iPad | Face ID / Touch ID | In-app and web payments |
| Mac | Touch ID / iPhone | Safari on macOS 10.12+ |
Apple Pay transactions follow the standard card dispute process. The tokenization provides additional security, but the underlying card network rules apply:
| Scenario | Liability Shift |
|---|---|
| Authenticated (Face ID / Touch ID) | ✅ Supported |
| Passcode fallback | ✅ Supported |
| Card-not-present (web) | ✅ With 3D Secure |
You can partially or fully refund any successful Apple Pay payment. The refund process is the same as card payments — see Refund APIPayments API for details.