Apple Pay Integration Guide

To enable Apple Pay on your site, follow these steps:

​

Prerequisites

1. HTTPS Hosting: Your site must be hosted on HTTPS to ensure secure transactions.
2. Domain Validation: Provide your domain to our support team for validation.

​

Download the Apple Validation File

Before proceeding, download the Apple Developer Merchant ID Domain Association File:

Download the Apple Developer Merchant ID Domain Association File

​

Setup Instructions

​

Step 1: Host the Apple Developer Merchant ID Domain Association File

You need to host the following endpoint on your server and return the Apple .txt validation file as plain text:

https://[your-domain]/.well-known/apple-developer-merchantid-domain-association

​

Example Setup Using Next.js App Router

Option 1: Using the Public Folder

1. Create a Public Folder: In your Next.js project, create the .well-known folder inside your public directory.

2. Add the Validation File: Paste the Apple verification txt with no extension in public/.well-known/.

   Filename: apple-developer-merchantid-domain-association

Option 2: Using a Route

1. Create the Route Structure: In your Next.js project, create a folder at:

   Path: app/.well-known/apple-developer-merchantid-domain-association/

2. Add a route.ts File: Inside the folder, create a route.ts file with the following content:

   route.ts

   import { NextResponse } from "next/server";
   
   export async function GET() {
       return new NextResponse("TXT-CONTENT", {
           headers: {
               "Content-Type": "text/plain",
           },
       });
   }
   

   Replace 'TXT-CONTENT' with the actual content of your Apple validation file.

​

Example Setup Using Next.js Page Router

1. Create a Public Folder: In your Next.js project, create the .well-known folder inside your public directory.

2. Add the Validation File: Paste the Apple verification txt with no extension in public/.well-known/.

   Filename: apple-developer-merchantid-domain-association

​

Example Setup Using Vite

1. Create a Public Folder: In your Vite project, create the .well-known folder inside your public directory.

2. Add the Validation File: Paste the Apple verification txt with no extension in public/.well-known/.

   Filename: apple-developer-merchantid-domain-association

​

Step 2: Test Apple Pay

Test Apple Pay on Safari (macOS) or any iOS device once setup is complete.

​

Local Testing

We recommend using ngrok to test your setup locally. Ngrok allows you to expose your local server to the internet securely. If possible, use a fixed domain with ngrok for consistent testing.

For further assistance, please contact our support team.