Apple Pay is a mobile payment service on Apple devices. To offer customers a more diverse payment experience, you can set up Apple Pay as a payment method through SHOPLINE Payments or Stripe.
In this article, you'll find:
1. Setting up Apple Pay
i. SHOPLINE Payments
Please note before setting:
- If your SHOPLINE Payments account has not yet completed the review, please refer to this article.
-
The feature is available to TWD/HKD stores or Taiwan/Hong Kong stores. The following table lists the credit cards/bank cards supported for Taiwan/Hong Kong stores.
Hong Kong Visa / Mastercard / JCB / UnionPay / American Express
- Please note that customers must have an Apple ID registered in China in order to link a UnionPay card.
Taiwan Visa / Mastercard / JCB
Step 1
Go to SHOPLINE Admin > [Settings] > [Payment Options]. Click the Add button to add the payment option.
Step 2
Select "SHOPLINE Payments" as the payment type, and select "Apple Pay" as the SHOPLINE Payments method.
*Note: If you currently use Apple Pay through Stripe, as our system doesn't support multiple Apple Pay payment channels simultaneously, please remove it before adding SHOPLINE Payments Apple Pay.
Step 3
In the SHOPLINE Admin, select [Hi, OOO] > [SHOPLINE Payments Account] at the top right. Or go to [Settings] > [Payment Options] and click View SHOPLINE Payments account.
Step 4
On the SHOPLINE Payments account page, go to [Manage merchants] > [Account setup] and click Edit in the "Domain settings" section.
Step 5
On the "Domain settings" page, click Add domain at the top right.
Step 6
When adding a new domain name, please select the checkbox for "Apple Pay domain name verification" to integrate your Apple Pay payment option. Click Submit to complete the setting.
*Note: You can add up to 5 domains. We recommend adding them in the following order.
- Add your free SHOPLINE URL.
For example, if your store URL is https://test456.shoplineapp.com, the free URL is test456.shoplineapp.com.
For more details on the free SHOPLINE URL, please refer to Basic Shop Address.
- If your store uses a custom URL, please also add it.
For example, if your store URL is https://www.test123.com, please add www.test123.com.
For more details on custom URL settings, please refer to Custom Domain Settings.
- If you are using the e-Commerce / Social Commerce plan features, please also add message-center-order.shoplineapp.com.
Please replace the example URLs above with your store URLs. If you're unsure of your store's free URL or custom URL, you can copy it from your store homepage or refer to Online Store Domain or Address and Custom Domain Application.
Step 7
The system will automatically redirect you back to the domain settings page. A blue exclamation mark icon will appear to the right of the newly added domain.
Click Refresh the list. If the blue exclamation mark disappears, the domain has been verified successfully.
If you see a yellow exclamation mark icon with the message "The verification payment method failed", please repeat the above steps to verify again.
Step 8
Once the verification is successful, go to [Settings] > [Payment Options] and publish Apple Pay to complete the Apple Pay payment setup.
ii. Stripe
Please note before setting:
- To use Apple Pay as a payment option, you need to apply for and activate a Stripe account. Please contact our Online Merchant Success Team and wait for approval.
- Stripe only supports users in Hong Kong and the US (supported currencies: HKD and USD). Therefore, it's only available to HKD stores/Hong Kong-based merchants.
Note: Stripe charges a transaction fee of 3.4% of the order total + HK$2.35 for each Apple Pay transaction. For more details on Stripe pricing, please refer to https://stripe.com/hk/pricing.
Step 1
Go to SHOPLINE Admin > [Settings] > [Payment Options]. Click the Add button to add the payment option.
Step 2
Select "Apple Pay" as the payment type. Click Activate to start setting up your account.
Step 3
- Stripe new user: please enter your information below, then click Authorize access to your account.
- Stripe existing user: click Sign in at the top right to log in to your account.
Step 4
You will be redirected back to the payment settings page in the SHOPLINE Admin, where you'll see that the system has filled in the Apple Pay Secret Key and Publishable Key.
You can now set up your payment fee, edit the name of your payment method for Apple Pay, and exclude any delivery options. Click Update to complete the setup.
Step 5
Log in to your Stripe account again and go to [Settings] > [Payment methods]. Click Configure next to Apple Pay and click Add new domain. Enter your store URL and click Add.
Step 6
Apple Pay is hidden by default. Please return to SHOPLINE Admin > [Settings] > [Payment Options] and click Publish to complete the setup.
2. Customer payment flow with Apple Pay
To use Apple Pay, customers need to add their credit or debit cards to their devices first.
Please check the following:
- Eligible device
- A supported card from a participating card issuer
- The latest version of iOS or macOS
- An Apple ID signed in to iCloud
For how to set up Apple Pay on other devices, please refer to Set up Apple Pay.
Notes:
- iPhone: Customers can select Apple Pay at checkout on Safari / Chrome / Microsoft Edge / Firefox / Opera. iOS 16 or later is required.
- Mac: Customers can select Apple Pay at checkout on Safari / Chrome / Microsoft Edge / Firefox / Opera. When using a non-Safari browser, customers need to scan the QR code with an iPhone that has Apple Pay set up and runs iOS 18 or later.
Step 1. Apple Pay
When the customer confirms the order and is ready to pay, they will find the button. Click the button to proceed to checkout.
Step 2. Payment authorization
The system will automatically redirect to the Apple Pay payment page.
- Desktop version (Safari): Customers can authorize the payment with their Apple Pay passcode/Touch ID.
- Desktop version (non-Safari): Customers must scan the code using an iPhone.
- Mobile version: Customers can authorize the payment with their Apple Pay passcode/Face ID/Touch ID.
To pay with a different credit or debit card, please refer to Make purchases using Apple Pay.
Desktop Safari browser
Desktop non-Safari browser
Step 3. Order completed
An order is created once the payment is successfully authorized.
3. Order details and refunds
i. Order details
To view the payment details, go to [Order Management] > [Orders] in the SHOPLINE Admin, click the order, and scroll down to the "Payment details" section.
ii. Issue refund
To issue a refund to a customer, click Refund in the "Payment details" section, then enter the refund amount and remarks. After confirming the refund details are correct, click Refund.
4. Notes
- SHOPLINE Payments Apple Pay currently does not support FamilyMart's frozen delivery service.
- The Apple Pay payment option is hidden by default. Please complete the domain verification before displaying it on your online store.
- This feature only supports payments on Apple devices. Users can pay with Apple Pay using Safari or other third-party browsers such as Chrome or Microsoft Edge.
- This feature currently only supports full payment by credit card and does not support credit card installments.
- The timeout for Apple Pay transactions is 5 minutes. If the payment isn't completed in time, the system will cancel the order.
Read more
Last updated: 9 November 2026
Comments