Apple Pay for the web
Overview
Apple Pay is easy and it works with Apple devices you use every day. You can make secure purchases in stores, in apps, and on the web.
The main advantages of the Apple Pay
For merchants: secure and simplified payment processing. Excellent support by Apple and improved user experience. For customers: safe and secure. It easy to pay using the Apple Wallet, manage billing and shipping addresses.
Before you start
Before setting up Apple Pay, a merchant must have a valid credit card setup with ECOM channels enabled. The supported card schemes are Visa, MasterCard, Amex and Discover. In order to use Apple Pay, the customer must use Safari on iOS or MacOS.
Customer Experience
Step | Description | Image |
---|---|---|
1 | The customer selects the Apple Pay payment method. | ![]() |
2 | The customer will be redirected to Apple Pay sheet. | ![]() |
3 | Customer selects payment details. | ![]() |
4 | Customer completes the payment. | ![]() |
PayEngine Details - Apple Pay
General
Name | Details |
---|---|
Product | Apple Pay |
Channels | ECOM |
Currencies | All currencies, supported by Credit Card setup |
Countries | List of countries available at https://support.apple.com/en-us/HT207957 |
Technical Flow | Asynchronous |
Recurring | No |
Chargebacks | No |
Reusable Payment Instruments | No |
Supported Features and Services
Name | Details |
---|---|
Debit | Yes |
Preauthorization | Yes |
Cancelation | Yes |
Capture | Yes |
Refunds | Yes |
Notifications | Yes (webhook and email) |
Settlement Reporting | Yes |
Integration Types
Name | Details |
---|---|
API | Yes |
Widget | Yes |
Widget as a Bridge | No |
Shop Plugin | No |
Paylink | No |
Integration via API - Apple Pay
Technical Flow

Specifications
Shopper experience:
- The Apple Payment sheet is part of the iOS and MacOS systems. It does not redirect the customer nor does the customer leave the merchant's website at any time.
- It is important to notice that once the payment is completed, the user will remain on the same page. The widget provides successCallback/errorCallback/cancelCallback methods to handle the shopper experience on the merchant side.
Billing and shipping addresses:
- Optional property within the widget. They can be requested from Apple Pay and passed to the widget, which overrides the initial billing and shipping addresses.
Direct API integration:
- The token, received from Apple Pay must be submitted within the "payment" object under key "applePayToken". Example:
Token
"applePayToken": { "paymentData":{ "version":"EC_v1","data":"xPE3fXmvym6529AxxQw2PN6czhxoXj2ylfHnJdiRdZktiMdDe2.........", "signature":"MIAGCSqGSIb3DQEHAqCAMIACAQExDzANBglghkgBZQMEAgEFADCAB......",
Samples
The token provided below is generated using a specific encryption key. It cannot be used as an example requests in our API. Please, update it with a token, generated using your own encryption key within PayEngine.
Preauth Request
{ "product" : "applepay", "merchantOrderId": "1231258912561259", "description": "test transaction",
Preauth Response
{ "createdAt": 1589364201986, "modifiedAt": 1589364202094, "merchantId": "Merchant-11111111-1111-1111-1111-111111111111",
Capture Request
{ "description": "Capturing the preauth", "initialAmount": 1190, "currency": "EUR"
Capture Response
{ "createdAt": 1589364459516, "modifiedAt": 1589364459523, "type": "CAPTURE",