Payment Services installation

This guide explains how to install and configure the Payment Services drop-in component in your storefront.

Onboard to Payment Services

Before you can use the Payment Services component in your storefront, you must onboard to Payment Services in the Adobe Commerce Admin.

Payment Services extension

The Payment Services drop-in requires the Payment Services extension version 2.10.0 or higher. PaaS only

Register your storefront domain with Apple

The following steps explain how to register your storefront domain with Apple, which is required to use Apple Pay.

Download the file SaaS only

Download the Apple Pay domain verification file. Click to download .

Serve as binary content SaaS only

Add the file to the following path in your storefront repository. Note the added .bin extension, which is currently the only way available in EDS to serve binary content.

/.well-known/apple-developer-merchantid-domain-association.bin

Set up URL redirect SaaS only

Add a redirect to make the domain verification file accessible at https://your-sandbox-domain.com/.well-known/apple-developer-merchantid-domain-association.

Source	Destination
.well-known/apple-developer-merchantid-domain-association	/.well-known/apple-developer-merchantid-domain-association.bin

Sandbox only

Serving the file via a redirect works for sandbox domain registration, but not for production. In production, the file must be served directly, without a redirect.

Register sandbox domain

Contact your sales representative to register the sandbox domain with Apple.

Set up production URL rewrite SaaS only

Set up a URL rewrite at the CDN level to make the domain verification file directly accessible at https://your-production-domain.com/.well-known/apple-developer-merchantid-domain-association, without redirects.

Register production domain

Contact your sales representative to register the production domain with Apple.