Apple Pay Setup & Customer Checkout Flow


To provide a better customer experience, merchants can now set up Apple Pay as a new payment option. 

This article will cover:

1. Setting up Apple Pay

A. Stripe

Remarks: You will need a Stripe account to activate the Apple Pay payment option. Stripe is now currently only available to merchants located in Hong Kong& USA. Supported currencies are HKD/USD.

Transaction fee for Apple Pay: 3.4% + HK$2.35 per successful card charge

The price is the same for all major cards. There’s no additional fee for international cards, failed charges, or refunds. For more details, please visit:


Step 1. Add Payment Options

Go to your SHOPLINE Admin Panel > [Settings] > [Payment Options]. Click the Add button to add the payment option.


Step 2. Setting up your account

Select "Apple Pay" for the payment type. Click Activate to start setting up your account.



Step 3. Sign in

You will be directed to a page as shown below. 

If you already have a Stripe account, click Sign in at the top right to login to your account; 
For new registrations, please enter your information below, then click Authorize access to your account.



Step 4. Update

You will be redirected back to the SHOPLINE Admin after authorization.

Here you will see the system has updated the payment method with Stripe's secret key & Publishable key. You can now set up your payment processing fee, edit the name of your payment method for Apple Pay and check if you need to exclude any delivery options.

After you've done the setup, click Update to add Apple Pay as a payment option.



Step 5. Register your domain with Apple

Log in to your Stripe account again.

Click Settings > Payment methods. Click Configure next to Apple Pay. Click Add new domain button to input your shop domain. Click Add to complete the setup.



Step 6. Publish

Although Apple Pay has been added, it is still not visible in your store.

Please return to the SHOPLINE Admin > [Settings] > [Payment Options]. Click Publish to start using this payment method in your store.



B. SHOPLINE Payments

Step 1

Go to your SHOPLINE Admin Panel > [Settings] > [Payment Options]. Click the Add button to add the payment option.


Step 2

Select "SHOPLINE Payments" for the payment type, and select "Apple Pay" for the SHOPLINE Payments method.



*Note: If you are using the Apple Pay payment option provided by Stripe, since the system does not support the creation of more than one Apple Pay payment channel at the same time, please delete it before adding SHOPLINE Payments Apple Pay.


Step 3

Click View SHOPLINE Payments account to verify the domain name.



Step 4

On the SHOPLINE Payment account page, click Set up in the "Account settings" section.



Step 5

Click Add domain name to add at most 5 domain names.



Step 6

When adding a new domain name, please check the box for "Apple Pay domain name verification" to integrate your Apple Pay payment option. Click Submit to complete the setting.



Step 7

After submitting, the system will automatically jump back to the setting page. A blue exclamation mark icon will appear on the right side of the newly added domain.

Click Reset the list. The domain verification is successful if the blue exclamation mark disappears.



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

After the verification is successful, go to [Settings] > [Payment Options] and publish Apple Pay to complete the Apple Pay payment option setup.



2. Customer's checkout flow using Apple Pay

To get started, customers need to add their debit, credit, or prepaid cards to their devices first.

Please check if the customers have fulfilled the following standards:

Here we'll demonstrate how to set up Apple Pay on mobile. Click here to learn setup procedures for other devices.


Step 1. Add Credit or Debit Card

Go to Wallet > tap Add Credit or Debit Card.


Step 2. Add a new card

Follow the steps to add a new card. If you're asked to add the card that you use with iTunes, just enter its security code > Tap Next.


Step 3. Verify the card

Your bank or card issuer will verify your information and decide if you can add your card to Apple Pay. If your bank or issuer needs more information to verify your card, they'll ask you for it.

Go back to Settings > Wallet & Apple Pay and tap your card.


Step 4. Complete

After your bank or issuer verifies your card, tap Next.
You can now start using Apple Pay.


3. Checkout in the mobile version

*Note: You need to set Safari as the browser to place orders.


Step 1. Apple Pay

After customers confirm their purchase and proceed to checkout, they will see the "Apple Pay" button.


Step 2. Touch ID

Payment details then popped up. Customers can select different payment cards by tapping the > button if they have added more than one card in Wallet.

After that, customers have to authenticate payment by scanning their fingerprints with Touch ID or scanning their faces with Face ID to complete the purchase.


4. Checkout in the desktop version

If customers are not using MacBook with Touch ID, the checkout procedure is slightly different. Here we will demonstrate checkout flow using Mac without Touch ID and authenticating payment with iPhone. 

You will need to fulfill the following requirements:

  • Mac is updated to macOS Sierra
  • Use Safari to place an order
  • Both phone and Mac are connected to the same iCloud account 
  • The Bluetooth function of the phone and Mac are turned on

If the customer's device does not support Apple Pay, you'll see the following message on the checkout page. Screen_Shot_2017-09-14_at_3.53.36_pm.png


Step 1. Apple Pay

After customers confirm purchases and choose Apple Pay as the payment method, a dialog will appear as shown below.

Customers can double-check the shipping address and contact information, and select another card for payment if they have added more than one card in Wallet.

Note: You can select credit and debit cards from any iPhone or Apple Watch that is nearby and sign into the same iCloud account.


Step 2. Confirm payment

Click to confirm the device proceeding payment and scan your fingerprint or face using the selected device.


Step 3. Done

When your payment is successful, you'll see "Done" and a checkmark on the screen.


Click here to check out other Apple Pay payment procedures.






Have more questions? Submit a request