Integrate Apple Pay into your existing WooCommerce platform with ease. This guide assumes you have already installed and configured the primary 'Total Processing Card Payments & Gateway for WooCommerce' plugin.
Account setup
Before you begin accepting Apple Pay payments on your WooCommerce store, ensure you meet the necessary requirements. You can use your current credentials from the existing WooCommerce plugin or request a separate channel for Apple Pay transactions.
To create a separate account for Apple Pay, contact the Total Processing support team. Once set up, the new channel and credentials will be available in your Total Control account.
Installation
Follow the steps below to install the Apple Pay plugin on your WooCommerce platform.
-
1. Download the plugin
Download the plugin file below and save it as a zip file. This file contains all necessary components for integrating Apple Pay with WooCommerce.
Apple Pay WooCommerce Zip500 KB -
2. Upload the zip file
2.1 Log in to your WooCommerce admin area and navigate to Plugins > Add New Plugin.
2.2 Click 'Upload Plugin' at the top of the page, select the Apple Pay plugin zip file, and click 'Install Now'.
Configuration
Once you have successfully installed the Apple Pay plugin, you will be able to locate this in your listing of 'Installed Plugins'. You will now need to activate and configure the Apple Pay plugin settings.
-
1. Activate the plugin
1.1 Locate your new Apple Pay Total Processing plugin within your listing of 'Installed Plugins'.
1.2 Under the plugin name, click on 'Activate'. Once activated, click 'Settings' to begin configuring the Apple Pay plugin. Continue to the next step to get started configuring.
-
2. Configure Apple Pay Settings
The Apple Pay plugin settings is grouped into different configuration areas. Navigate through each tab below to configure the plugin.
-
To begin, log in to your WordPress dashboard and navigate to the Apple Pay Plugin settings page. You will automatically by directed to the 'General Settings' page. Review and fill in all the required information.
Item Description Required Example Enable/Disable Enable or disable Apple Pay checkout functionality. Yes Tick box to turn on Apple Pay payment functionality Title Title text of the payment method. Yes Leave as 'ApplePay' Description This controls the description seen at the checkout. Yes Ensure the text meets Apple guidelines. You can review these here. Button visible to IP list only Used to enable the restriction of specific IP addresses. No N/A Allowed IPv4 addresses Description list of IP addresses allowed for Apple Pay use. No Must contain comma-separated values of IP addresses. Button visible to admin logged in users only If ticked, admin users only can view the Apple Pay button. No N/A Logged in users only Only allow clients logged into the profile of the website to view Apple Pay as a checkout option. No N/A Enforce no shipping Allow or disallow for shipping details to appear on Apple Pay checkout. No N/A Enforce terms checkbox on checkout page Enable/disable checkout terms and conditions appearing before the Apple Pay checkout sheet is produced. No N/A Enable console log Default is off. Only select if the following procedures are met:
- Total Processing has requested to turn on Console.log events.
- You have privatised Apple Pay by selecting 'Button visible to admin logged in users only'.
No Refer to 'Description' -
Configuration settings are those settings applied to payment types, payment methods and extended CSS styling for the Apple Pay checkout. Scroll through the table to the right and fill in the necessary information. After you're complete, click 'Next'.
Option Description Your store name Enter the name of your store as you want it to appear on the Apple Pay payment sheet. Billing narrative Enter a brief description of the product or service being purchased. Merchant two-letter ISO 3166 country code Choose the two-letter ISO 3166 country code that corresponds to the country where your store is located. The default is 'United Kingdom of Great Britain and Northern Ireland'. Apple Pay JS version# View the version number of the Apple Pay JS code currently loaded on the payment sheet. The default is 'macOS 10.14.4, iOS 12.2'. Payment capabilities supported by the Merchant Account Category Choose the payment capabilities supported by your Merchant Account Category. The default options are '3D Secure', 'Debit cards', and 'Credit cards'. Card schemes enabled Choose the card schemes that are enabled for payment. The default options are 'Mastercard' and 'Visa'. Block card issuers from selected countries Block card issuers from selected countries if necessary. Reload action page on dismiss Choose whether to reload the action page on dismiss. The default is 'On'. Reload payment page on closure Choose whether to reload the payment page on closure. Force account creation on order completed Choose whether to force account creation on order completed. The default is 'No'. Force shipping methods tax Choose whether to force the shipping method tax to be included. The default is 'No'. Custom button CSS Add custom CSS code to customise the appearance of the Apple Pay button. -
Style settings are those settings applied to your Apple Pay checkout to create the look and feel you want your customers to experience. Scroll through the table to the right and fill in the necessary information. After you're complete, click 'Next'.
Option Description Default button colour Choose the default colour for the Apple Pay button. The default colour is black. Default button type Choose the default button type for the Apple Pay button. The default type is plain. Default button language Choose the default language for the Apple Pay button. The default language is English (UK). Display areas Choose where you want the Apple Pay button to appear on your site. You can choose to display the button in the view basket/cart page and/or on the checkout page. Cart/basket button colour Choose the colour of the Apple Pay button for the cart/basket page. The default colour is the same as the default button colour. Cart/basket button type Choose the button type of the Apple Pay button for the cart/basket page. The default type is 'Checkout'. Mini cart/basket button colour Choose the colour of the Apple Pay button for the mini cart/basket. The default coloir is the same as the default button colour. Mini cart/basket button type Choose the button type of the Apple Pay button for the mini cart/basket. The default type is 'Checkout'. Checkout button positioning Choose where you want the Apple Pay button to appear on the checkout page. You can choose to place it after the payment methods. Checkout button colour Choose the colour of the Apple Pay button for the checkout page. The default colour is the same as the default button colour. Checkout button type Choose the button type of the Apple Pay button for the checkout page. The default type is 'Checkout'. Product button colour Choose the colour of the Apple Pay button for the product page. The default colour is the same as the default button colour. Product button type Choose the button type of the Apple Pay button for the product page. The default type is 'Buy'. Mini cart HTML container Add HTML code -
The statistics page shows a detailed statistics overview for the payment method. Within the 'Status' section, you will be able to see a holistic overview of all the settings you have applied from the previous sections.
Apple validation & session requirements
Please ensure the following items are performed within the 'Status Settings' tab:
-
Apple Pay session requirements
Ensure you have clicked 'Initiate Request' in order to successfully pair the Total Processing Apple Developer ID with your new checkout. This will ensure a connection to Apple to be able to take payments.
-
Apple domain verification
After the 'Initiate Request' button is ticked, refresh the page and go to the 'Apple Domain Validation' area. Make sure that this area shows with a green tick to show the connection is successful for your Apple Pay sessions.
-
-