Skip to content
/
Set-Up Apple Pay
Last updated

Set-Up Apple Pay

Overview

Before you can start accepting Apple Pay payments through Ryft, there are a few setup steps that need to be completed.

This involves configuring your Web Domains and iOS certificates to ensure that Apple Pay transactions can be processed securely.

Apple Pay Certificate

The first step in enabling Apple Pay payments via web is a processing certificate.

This certificate is used to encrypt payment information and ensure secure transactions between your website and Apple Pay which in turn requires an active Apple Developer account.

Ryft simplifies this process by providing a hosted Apple Pay certificate option, which is the recommended approach for most businesses. This means that Ryft will manage the Apple Pay certificate on your behalf, reducing the complexity of the setup process, and allowing you to get started with Apple Pay quickly.

In order to use Ryft's hosted Apple Pay certificate, you simply need to complete the Apple Pay domain verification process as described in the next section.

Domain Association File

To verify your domain for Apple Pay, your domain must have a valid SSL certificate. This is a requirement from Apple to ensure secure communication between your website and Apple Pay.

Ryft allows your domains to be configured for Apple Pay via our Portal or using our API. Regardless of the preferred method, the following prerequisite steps must be completed:

  1. Download our Domain Association File: This file is required by Apple to verify your domain. You can download it from the Ryft Portal on this page when using the Sandbox environment, or this page when using the Production environment.
  2. Host the File on Your Website: Upload the downloaded file to the .well-known directory of your website. The file must be accessible at the following URL: https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association.

You must ensure that the file:

  • have Content-Type: application/octet-stream or Content-Type: text/plain header when served;
  • is publicly accessible without any password protection or authentication;
  • is not behind a proxy, firewall, or any other access control mechanism that could prevent Apple from accessing it.

Verifying Your Domain

Once the domain association file is hosted on your website, you can verify your domain using either the Ryft Portal or the Ryft API.

However, if you are processing payments for Sub-Accounts, then you should create a separate domain registration for each Sub-Account, which can be done via the API only.

  1. Login to your Ryft Account;
  2. Navigate to this page when using the Sandbox environment, or this page when using the Production environment;
  3. Click on Add Domain button and follow the instructions to add and verify your domain.

Please note that:

  • You can have a maximum of 99 domains registered for Apple Pay across your Ryft Account. The same limit applies to each Sub-Account if you are processing payments for Sub-Accounts.
  • As mentioned above, in order to process Apple Pay payments, the domain must be publicly accessible. This implies that localhost or any other local development environment cannot be used for testing Apple Pay payments.
Previous page
Next page