# Legacy Apple Pay Setup (Apple Pay Plugin)

{% hint style="danger" %}
**Not all gateways support Apple Pay. Apple Pay is supported on Acquired3DS, Adyen, Authorize.netV2, Bambora, cardstream, Celerispay, CheckoutV2, Easy Pay Direct, Gala Technology, Merchant Warrior, MerchantConnect, MerchantConnectV2, NMI, NomuPay, PaysafeV2, Priority, SquareV2, SquareV2, StripeV2, Surgeify, Swipen, TotalApps, Truevo, Vantiv, VantivV2, Verifi, Whitelabel Payments, WorldlineV2, Worldpay.**
{% endhint %}

{% hint style="danger" %}
**This Apple Pay setup method should only be used if you are using your own Apple Pay Developer Account with the Apple Pay plugin.** 
{% endhint %}

{% hint style="warning" %}
**Apple Pay setup requires successful configuration of your Apple Pay Certificates, Identifiers & Profiles in your Apple Developer account. You can find more information on how to properly configure your Apple Pay account on the Apple side in the Apple Developer docs:** [**Configure Apple Pay**](https://developer.apple.com/help/account/configure-app-capabilities/configure-apple-pay)
{% endhint %}

{% hint style="warning" %}
**Payments cannot be processed without a valid Payment Processing Certificate from your Gateway. You will upload your Gateway’s Payment Processing Certificate (a “csr” file with a .certSigningRequest file extension) to your Apple Developer account.**
{% endhint %}

{% hint style="warning" %}
**Please Note: Your Gateway’s Payment Processing Certificate&#x20;**<mark style="color:orange;">**EXPIRES every 25 months**</mark>**. You will need to generate and upload a NEW certificate to your Apple Developer account prior to the expiration date.**
{% endhint %}

{% hint style="info" %}
***The button ONLY displays if customer's Apple Pay wallet is configured AND device supports Apple Pay (mac or iphone with touch ID).***
{% endhint %}

***

### Step 1: Login and navigate to the funnel on which to add Apple Pay <a href="#applepay-checkoutchamp-step1-loginandnavigatetothefunnelonwhichtoaddapplepay" id="applepay-checkoutchamp-step1-loginandnavigatetothefunnelonwhichtoaddapplepay"></a>

<figure><img src="/files/POL4K3dsVFuvMMgVq90L" alt="" width="563"><figcaption></figcaption></figure>

***

### Step 2: Click the gear button on the top left to open the funnel settings <a href="#applepay-checkoutchamp-step2-clickthegearbuttononthetoplefttoopenthefunnelsettings" id="applepay-checkoutchamp-step2-clickthegearbuttononthetoplefttoopenthefunnelsettings"></a>

<figure><img src="/files/t0VD5eEp4gumihgk7XgR" alt="" width="559"><figcaption></figcaption></figure>

***

### Step 3: Open the Payments section <a href="#applepay-checkoutchamp-step3-openthepaymentssection" id="applepay-checkoutchamp-step3-openthepaymentssection"></a>

<figure><img src="/files/rWElE5lZD24v3KtDXzQI" alt="" width="538"><figcaption></figcaption></figure>

***

### Step 4: Choose an existing Apple Pay plugin / Merchant ID configuration or click the plus sign to create a new one. <a href="#applepay-checkoutchamp-step4-chooseanexistingapplepayplugin-merchantidconfigurationorclicktheplussig" id="applepay-checkoutchamp-step4-chooseanexistingapplepayplugin-merchantidconfigurationorclicktheplussig"></a>

<figure><img src="/files/hqLcSTm7FZmiAVklF6cz" alt="" width="494"><figcaption></figcaption></figure>

{% hint style="info" %}
***If you click the plus sign to create a new plugin, you will need to copy and paste the credentials detailed in Step 5.***
{% endhint %}

***

### Step 5: Add the Apple Pay Merchant credentials <a href="#applepay-checkoutchamp-step5-addtheapplepaymerchantcredentials" id="applepay-checkoutchamp-step5-addtheapplepaymerchantcredentials"></a>

<figure><img src="/files/uJwoq6JqXu4C8ny0yLGg" alt="" width="563"><figcaption></figcaption></figure>

**merchantIdentifier**:

* Your Apple Pay **Merchant Identifier**
* Can be found on your Apple Developer Account at <https://developer.apple.com/account/resources/identifiers/list/merchant>

**Download your Merchant Identity Certificate and its Private Key**

<figure><img src="/files/KaEXok729e59PgpR4fqs" alt="" width="563"><figcaption></figcaption></figure>

* To download your Merchant Identity Certificate and its Private Key, first open Keychain Access.
* Navigate to the “Certificates” section.
* Highlight both the certificate and the key (down arrow).
* Right click.
* Export 2 items.
* File format Personal Information Exchange (.p12)
* Convert the .p12 file to PEM format
  * Launch the terminal on your Mac.
  * Change directory to the folder where you have saved the .p12 file.
  * Run the following openssl pkcs12 command to generate a .pem file:
    * openssl pkcs12 -in pushcert.p12 -out pushcert.pem -nodes -clcerts

**merchantCert**:

* Your Apple Pay **Merchant Identity Certificate**
* As noted above, this must be downloaded from your Apple Account and converted to PEM format.
* Open your new PEM file in a text editor, like Notepad. Copy the contents of the text file and paste into the “merchantCert” box.
* Pasted text must include everything from “-----BEGIN CERTIFICATE-----” to “-----END CERTIFICATE-----”.

**certPrivateKey**:

* The **private key** of your Merchant Identity Certificate
* This must be converted to PEM format along with your downloaded Apple Pay Merchant Identity Certificate
* Open your new PEM file in a text editor, like Notepad. Copy the contents of the text file and paste into the “certPrivateKey” box
* Pasted text must include everything from “-----BEGIN PRIVATE KEY-----” to “-----END PRIVATE KEY-----”.

**displayName**:

* Default merchant name to display to the customer while authorizing payment
  * Ex: "Touch ID to Pay **My Store** (displayName) $118.00"

***

### Step 6: Save and Continue <a href="#applepay-checkoutchamp-step6-saveandcontinue" id="applepay-checkoutchamp-step6-saveandcontinue"></a>

***

### Step 7: Configure Apple Pay funnel settings. <a href="#applepay-checkoutchamp-step7-configureapplepayfunnelsettings" id="applepay-checkoutchamp-step7-configureapplepayfunnelsettings"></a>

<figure><img src="/files/ARlguFXffcldt7396q9Y" alt="" width="494"><figcaption></figcaption></figure>

* **Gateway**: Gateway on which to process a transaction the with Apple Pay token. Gateway is optional. Not entering a gateway will process the transaction on the gateway assigned to the product purchased. Do ensure the gateway is in the supported list at the top of this document. Also ensure you have uploaded a valid Payment Processing Certificate from your Gateway in your Apple Developer account.
* **Plugin**: Apple Pay plugin / Merchant ID configuration settings to use to create Apple Payment Sessions. This is required.
* **Merchant Name**: Customizable funnel merchant name to display to the customer while authorizing payment. If not entered, the session will default to the plugin settings displayName.
  * Ex: "Touch ID to Pay **My Store** (displayName) $118.00"
* **Country**: Country to use for Apple Pay Session
* You will upload **Domain File** in Step 9.

***

### Step 8: Save and Continue <a href="#applepay-checkoutchamp-step8-saveandcontinue" id="applepay-checkoutchamp-step8-saveandcontinue"></a>

***

### Step 9: Upload Apple’s Domain Verification File and verify your domain on your Apple account <a href="#applepay-checkoutchamp-step9-uploadapplesdomainverificationfileandverifyyourdomainonyourappleaccount" id="applepay-checkoutchamp-step9-uploadapplesdomainverificationfileandverifyyourdomainonyourappleaccount"></a>

1. Go to <https://developer.apple.com/account/resources/identifiers/list/merchant> and select the Merchant ID that you are using with this funnel.
2. On the Edit or Configure Merchant ID page, go to Merchant Domains section and click Add Domain.
3. Enter your funnel domain and save.
4. Click Download and download the apple-developer-merchantid-domain-association txt file.
5. On your funnel Payments settings, click Choose File next to the Domain File label.
6. Select your downloaded verification text file and click Open.
7. Publish the funnel. This will upload the file to the .well-known folder on your funnel.
8. Click Verify back on your Apple Merchant Domain page.

{% hint style="danger" %}
When using Apple Pay in multiple funnels published to the same domain, you will need to upload the file to a single funnel and publish that funnel as the default funnel.
{% endhint %}

{% hint style="info" %}
***If integrating with Stripe and verification returns a 404 error from Stripe, you may need to submit a Checkout Champ support ticket to have our development team manually remove the “.txt” file extension from the uploaded file.***

***Likewise, submit a Checkout Champ support ticket in the event an incorrect Domain File is uploaded, or an existing file needs to be replaced.***
{% endhint %}

***

### Step 10: Edit Checkout page and add Apple Pay button <a href="#applepay-checkoutchamp-step10-editcheckoutpageandaddapplepaybutton" id="applepay-checkoutchamp-step10-editcheckoutpageandaddapplepaybutton"></a>

<figure><img src="/files/7HffDIJSP3supyMsm3XZ" alt="" width="183"><figcaption></figcaption></figure>

<figure><img src="/files/tn42JT1rHnocVYsvl2sf" alt="" width="563"><figcaption></figcaption></figure>

#### Step 10-1: Customize size of button by clicking on the button and dragging the highlighted corners or use Dimensions tab for advanced edits. <a href="#applepay-checkoutchamp-step10-1-customizesizeofbuttonbyclickingonthebuttonanddraggingthehighlightedc" id="applepay-checkoutchamp-step10-1-customizesizeofbuttonbyclickingonthebuttonanddraggingthehighlightedc"></a>

<figure><img src="/files/HAC6gtFTC3MYfXFpCSQn" alt="" width="288"><figcaption></figcaption></figure>

#### An Apple Pay button on a published page will be visible only on Apple devices, and its appearance will follow Apple Pay button CSS styling. <a href="#applepay-checkoutchamp-anapplepaybuttononapublishedpagewillbevisibleonlyonappledevices-anditsappeara" id="applepay-checkoutchamp-anapplepaybuttononapublishedpagewillbevisibleonlyonappledevices-anditsappeara"></a>

<figure><img src="/files/fHGmeS55TTFMRKq9bynX" alt="" width="350"><figcaption><p>Apple Pay buttons as shown in the page builder</p></figcaption></figure>

<figure><img src="/files/W9pXC5tTIGZUCUK3WY7R" alt="" width="563"><figcaption><p><strong>Apple Pay Buttons as shown on published checkout page on Apple devices.</strong></p></figcaption></figure>

***

### Step 11: Save the page and exit the page builder. <a href="#applepay-checkoutchamp-step11-savethepageandexitthepagebuilder" id="applepay-checkoutchamp-step11-savethepageandexitthepagebuilder"></a>

<figure><img src="/files/ot0Ux6GEzBerL6ZcqtC8" alt="" width="317"><figcaption></figcaption></figure>

***

### Step 12: On the arrow leaving the checkout page, choose the Apple Pay button for navigation. <a href="#applepay-checkoutchamp-step12-onthearrowleavingthecheckoutpage-choosetheapplepaybuttonfornavigation" id="applepay-checkoutchamp-step12-onthearrowleavingthecheckoutpage-choosetheapplepaybuttonfornavigation"></a>

<figure><img src="/files/RqNAxK7pCNfpOUKoMHH1" alt="" width="466"><figcaption></figcaption></figure>

***

### Step 13: Upsell pages <a href="#applepay-checkoutchamp-step13-upsellpages" id="applepay-checkoutchamp-step13-upsellpages"></a>

{% hint style="info" %}
There are 3 options for upsell pages. Communicate with your gateway about the appropriate workflow.
{% endhint %}

Option 1:

**Your gateway supports a 1-click upsell on Apple Pay using a payment token returned from the gateway at checkout**

Place one or more standard buttons on each upsell page. Follow standard instructions for those buttons to submit the upsell. Add class **cc-one-click-btn** to each button. There is no need to have an Apple Pay button on each page. The buttons will submit using the original payment token.

&#x20;

Option 2:

**Your gateway does not support Option 1. You prefer to have a generic button on upsell pages instead of an Apple button.**

Place one or more standard buttons on each upsell page. Follow standard instructions for those buttons to submit the upsell. The buttons will automatically support Apple Pay or non-Apple Pay based on the checkout. Apple Pay will redirect the consumer to Apple to complete the upsell. No additional work is needed.

&#x20;

Option 3:

**Your gateway does not support Option 1. You prefer to have an Apple button on upsell pages.**

Place one or more standard buttons AND one or more Apple Pay buttons on each upsell page. Choose all the buttons on the arrow(s) leaving the page. When the live page loads the standard buttons are removed if the checkout was with Apple Pay. Pressing the Apple Pay buttons will redirect the consumer to Apple to complete the upsell. When the live page loads the Apple Pay buttons are removed if the checkout was not Apple Pay. The standard buttons will submit the upsell.

***

### Step 14: Publish the funnel. You’re done and ready to test! <a href="#applepay-checkoutchamp-step14-publishthefunnel.youredoneandreadytotest" id="applepay-checkoutchamp-step14-publishthefunnel.youredoneandreadytotest"></a>

<figure><img src="/files/j2mduMSg7LZvAUdwD5Fy" alt="" width="563"><figcaption></figcaption></figure>

***Apply Pay checkout is available only on Apple devices. Apple Pay buttons on a live page will only display on Apple devices.*** <https://support.apple.com/en-us/HT208531>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.checkoutchamp.com/funnel-builder/creating-and-editing-funnels-pages/funnel-visualizer-and-page-builder/funnel-visualizer/edit-funnel-settings/payments/apple-pay/legacy-apple-pay-setup-apple-pay-plugin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.