Skip to content

Apple Pay Direct

Christian Dangl edited this page Oct 2, 2020 · 12 revisions

(Plugin 1.6.0 and above)

Apple Pay Direct allows your customers to do a quick checkout on product detail pages or within their carts. You can activate this payment by simply activating the payment method "Apple Pay Direct" in your Shopware backend. If your shop theme is not too customized, the Apple Pay button should be displayed immediately in compatible browsers after clearing your caches. Customers can immediately proceed with the checkout, while Shopware creates a simple guest account for them.

Minimum Requirements for Apple Pay

Please note, that there are some minimum requirements to be able to use Apple Pay in your shop.

Shop Requirements

  • Your Shop needs to use SSL on all pages. Please activate "SSL support" in the Basic settings of your Shopware backend for all shops that will allow Apple Pay Direct.

  • (Update the Mollie Plugin) and enable the new payment method "Apple Pay Direct" in your Shopware backend.

  • The Mollie plugin automatically downloads a domain verification file for Apple.

    This is located at:

    "https://{{your-domain}}/.well-known/apple-developer-merchantid-domain-association"

    Please keep in mind, this needs to be publicly available!

Browser Requirements

There are some requirements for customers to use Apple Pay.

They have to use a compatible browser (Safari) on a compatible MAC (or iOS device) that has a Apple Pay card available.

You can test if Apple Pay is available by opening this page with your browser: https://applepaydemo.apple.com

Configuration

Apple Pay Direct is integrated like every other payment method in Shopware. So you can set anything you would also configure for other payments.

Shipping Method

If you decide to assign different shipping methods and costs, the Apple Pay sheet will automatically show a dropdown selection and provide the user the option to select his preferred shipping.

Currencies

The Apple Pay sheet will automatically show the currency of your current shop. It's an ease to have international shops and different currencies running with Apple Pay.

Testing Apple Pay

You can easily test the Apple Pay Direct payment on your staging and testing system.

But please keep in mind, the domain verification that is done by Apple and Mollie only works with a Mollie LIVE API key.

So make sure you have both, the LIVE and TEST API key configured in the Mollie plugin and that TestMode is set to YES (testing active).

The domain verification will then be done using the LIVE key, and the actual payment is done using your TEST key.

Logs and Monitoring

Everything that can go wrong is added as a new log entry in the Shopware Backend Logs. Most of the time, the responses from the Mollie servers already tell you what the problem is.

Troubleshooting

If you have any problems by running Apple Pay Direct, please view the Shopware Backend Logs to see if an error happened. If so, it might already tell you what went wrong. Besides this, here are a few things that can go wrong.

Apple Pay buttons not visible

  • Did you setup everything as described in the requirements above?

  • What does the Apple demo page say? Can you even pay with Apple Pay on the device you are? https://applepaydemo.apple.com

  • Do you have a custom theme for your shop? Maybe the blocks are overwritten or removed, so that the buttons are not added correctly?

Payment not working

It could be that a payment might not work. You might even get a weird error in your logs like "Apple Pay payment service is temporarily down". This could mean the card that is used for Apple Pay is currently not supported by Mollie due to some encryption methods. That might involve cards issued by N26, or other. In this case, please contact the Mollie support, they can see what happens.

Clone this wiki locally