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.