Apple Pay

This guide outlines the basics of using Apple Pay via Nexi Checkout and gives you instructions needed for a fluent implementation.

IntegrationType: HostedPaymentPage, EmbeddedPaymentPage

Overview

Apple Pay is a mobile payment and digital wallet service provided by Apple Inc.

It allows users to make payments using their compatible Apple devices (such as iPhone, iPad, or Apple Watch) in physical stores, within apps, and on the web.
It provides a convenient and secure way for users to store their credit and debit card information and make payments with a single touch or glance.

Apple Pay uses a secure element within the device and Touch ID or Face ID to confirm payments, making it more secure than traditional card payments.

Functionality table

Name	Description
Payment type	Wallet
Subscriptions	❌
Bin filter	✅
Refunds	✅
Partial refund	✅
Update order	❌
Cancel payment	✅
Reservation & charge	✅
CPSP	✅
IPSP	direct contract, non-collecting (cards are not supported like Amex and Girocard)
Supported card schemes	Visa, Mastercard and Dankort
Currencies	All currencies for Visa and Mastercard. Only DKK for Dankort.
Countries	All

Apple Pay is only supported on iOS (16 or later) operating systems.
Supported browsers are: Safari, Firefox, Chrome, and Edge.

Apple Pay will not be shown in checkout if the above requirements are not met.

Apple Pay cannot be activated without Visa/Mastercard/Dankort being present on your account.

Activation

To activate Apple Pay as a payment method and to add it to your Nexi Checkout portal, you need to complete the onboarding journey.

You can activate Apple Pay as hosted and also as embedded checkout.

Hosted Payment Page

To activate the hosted checkout for Apple Pay, do the following:

Login to the Nexi Checkout portal.
Navigate to ADD-ON on left-hand side menu and ensure the your account is set to LIVE (top-right on screen).
Click on ENABLE APPLE PAY to activate the the Apple Pay option.

🎉

You have now successfully enabled Apple Pay as Hosted Payment Page in your checkout.

Embedded Payment Page

To activate the embedded checkout for Apple Pay, do the following:

Login to the Nexi Checkout portal.
Navigate to ADD-ON on left-hand side menu and ensure the your account is set to LIVE (top-right on screen).
Click on ENABLE APPLE PAY to activate the the Apple Pay option.
Write your domain name into the domain name box. Ensure that you write the correct domain name.
Click on DOWNLOAD to get your domain-verification file.
Upload the domain-verification file to your website at the URL at step 2 in the screenshot below.
Click on VERIFY DOMAIN.

🎉

You have now successfully enabled Apple Pay as Embedded Payment Page in your checkout.

User journey

This following section will describe the user journey and payment flow for your customer:

When your consumer chooses Apple Pay as a payment method in the checkout, they will prompted to Apple Pay window.
Customer can pay with

"Pay with Touch ID" or
"Double click to pay" depending on what system they are using.

Payment flow

If you use paymentMethodsConfiguration parameter to only show the payment method(s) that are preferred for the specific payment, Apple Pay can also be selected.
Apple Pay is available only on Apple devices.

Apple Pay is defined as a Wallet and can be displayed alone and together with other payment methods. It is not recommended to show Apple Pay alone if you do not detect the device used in the webshop before you are going to show the payment options.

If Apple Pay is used alone on devices other than iOS/iPadOS/MacOS, there will be no visible payment methods and it is naturally a poor user experience. Apple Pay can be combined with other Wallet payment methods or together with cards.

Recommended usage of the paymentMethodsConfiguration parameter for Apple Pay.

If you have more than one wallet configured, you can use:

code
paymentMethodsConfiguration:[{"name":"Wallet"}]

If Apple Pay is used as the only wallet, you should include card as well:

code
paymentMethodsConfiguration:[{"name":"Card"},{"name":"ApplePay"}]