WooCommerce plugin, Merchant Integration Manual

Download WooCommerce module (updated 03.09.2024)

Features

• EveryPay WooCommerce plugin now supports Google Pay
• Apple Pay
• Adds EveryPay payment gateway service to WooCommerce for supporting Card, Open Banking and PayPal
• Enables embedding the payment form to the checkout workflow in iFrame for card payments
• Customer Initiated Token (one-click) payment allow returning customers to perform payments faster and easier using saved card details

Requirements

The extension has been tested to work with the following software versions:

• WordPress 5.2.X and above
• WooCommerce 3.6.X and above
• PHP 5.6 or above

However, it’s possible that the extension works even when these are not met.

Installation

EveryPay extension is available on EveryPay Support website free of charge.

Installation steps:

1. Download the latest version from EveryPay Merchant support page
2. Install plugin from ZIP file via WordPress plugin manager
3. Go to WooCommerc/Settings/Payments/EveryPay, enable it, and enter your API username and password that can be found in EveryPay Merchant Portal (see more detailed instructions below)

EveryPay gateway plugin has support for English and Estonian language included, additional translations can be added by translating .pot file found in the “languages” directory or using 3rd party plugin for string translations.

Configuration

Once the plugin is activated configuration options for EveryPay gateway can be found in WordPress Dashboard, WooCommerce/Settings/Payments/EveryPay.

Due to the reason that some of the banks do not support 3DS inside the iFrame we recommend choosing “Redirect to hosted form on EveryPay server” payment integration variant.

Accept Google Pay payments

Note that to accept Google Pay payment on the Web, you need to serve from an HTTPS webpage with a TLS domain-validated certificate.

• To accept Google Pay payments, you must register with Google and receive a Merchant ID, adding the necessary information in Google Pay API section via Google Pay and Wallet Console
• From your Merchant portal, go to E-shop Settings
• Choose the right E-shop and go to Google Pay section at the bottom of the page
• Read and confirm Google Pay Terms and Conditions by clicking the checkbox
• In the “Google Pay Merchant ID for Custom Domains” field enter the Google Merchant ID obtained from the Google Pay and Wallet Console and press “Save” (in the test environment, a random value can be entered)
  • In the Google Pay section, there should be: “Registered” with Google Pay Merchant ID and the option to “Unregister”

If everything is set up correctly, when customers go to the checkout page, the Google Pay payment method will be present.

To initiate a Google Pay payment in the test environment, just add a genuine card to your Google Wallet. You can relax knowing that no funds will be deducted, as a red notification will inform you – Your payment method won’t be charged because you’re in a test environment.

Accept Apple Pay payments

Contact the acquiring bank if you would like to start accepting Apple Pay payments.

The handling of Apple Pay payments in E-shop requires:

• All pages that include Apple Pay must be served over HTTPS
• Webstore domain must have a valid SSL certificate
• Your server is set up for secure communication with Apple Pay. Follow the Apple Pay Guide
• Active registered e-shop in EveryPay merchant portal
• Enabled card payment method

Preparations:

1. Download domain verification file:

• From your Merchant portal, go to E-shop Settings
• Choose the right E-shop and go to Apple Pay section
• Download domain verification file
• Host file’s content to https://[DOMAIN_NAME]/.well-known/ folder in your website’s root directory
• Corresponding file should be reachable from https://[DOMAIN_NAME]/.well-known/apple-developer-merchantid-domain-association

2. Register E-shop domain:

• From your Merchant portal, go to E-shop Settings
• Choose the right E-shop and go to Apple Pay section
• Click + icon and enter your webstore domain or sub-domain where the Apple Pay payment will take place (e.g. example.com, www.example.com etc.)
• Click Add domain
• Check registration status. If the result is correct, the status registered and the corresponding domain should be displayed

If everything is set up correctly, when customers go to the checkout page, the Apple Pay payment method will be present if an eligible device and browser are being used.

Callback notification set up in merchant portal

For the plugin to work correctly, Callback URL needs to be added in the Merchant portal. Copy the “Callback Notification URL” from the plugin settings and paste it into the Merchant Portal/E-shop settings/Callback Notification URL field.

Callback notifications are used to inform the plugin about payment status updates. When the payment is finalized by the customer, Callback is sent to the URL that was added in the Merchant portal and a payment status request is made showing the correct payment status to the customer and in the WooCommerce/Orders section.

Version history: