Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

Not all gateways support Apple Pay. Apple Pay is supported on Acquired .com , Adyen, Blue Snap, Braintree, Cardstream, Checkout .com , Computop, Merchant Warrior, NMI, NomuPay, Paysafe, Priority Payment Systems, Square, Stripe, Surgeify, Swipen, Total Apps, Vantiv, Verifi, and WorldLine.

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

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.

Please Note: Your Gateway’s Payment Processing Certificate EXPIRES every 25 months. You will need to generate and upload a NEW certificate to your Apple Developer account prior to the expiration date.

The button ONLY displays if customer's Apple Pay wallet is configured AND device supports Apple Pay (mac or iphone with touch ID).


Step 1: Login and navigate to the funnel on which to add Apple Pay


Step 2: Click the gear button on the top left to open the funnel settings


Step 3: Open the Payments section


Step 4: Choose an existing Apple Pay plugin / Merchant ID configuration or click the plus sign to create a new one.

If you click the plus sign to create a new plugin, you will need to copy and paste the credentials detailed in Step 5.


Step 5: Add the Apple Pay Merchant credentials

merchantIdentifier:

merchantCert:

  • Your Apple Pay Merchant Identity Certificate

  • This must be downloaded from your Apple Account and converted to PEM format

    • One option to convert to PEM is as follows:

      • On the Mac, open Keychain Access

      • From the sidebar, select System Roots

      • Locate the certificate to export

      • Select File > Export Items

      • Select a location to save the certificate and select the Privacy Enhanced Mail (.pem) file 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


Step 7: Configure Apple Pay funnel settings.

  • 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


Step 9: Upload Apple’s Domain Verification File and verify your domain on your Apple account

  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.

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.


Step 10: Edit Checkout page and add Apple Pay button

Step 10-1: Customize size of button by clicking on the button and dragging the highlighted corners or use Dimensions tab for advanced edits.

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.

Apple Pay Buttons as shown in the Web Builder.
Apple Pay Buttons as shown on published checkout page on Apple devices.

Step 11: Save the page and exit the page builder.


Step 12: On the arrow leaving the checkout page, choose the Apple Pay button for navigation.


Step 13: Publish the funnel. You’re done and ready to test!

Apple Pay buttons can also be used on Upsell pages when first used on Checkout pages.

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

  • No labels