WooCommerce plugin. Merchant Integration Manual
Updated 28.04.2021
Features
- Adds EveryPay payment gateway service to the WooCommerce installation for
supporting Card and Open Banking payments.
- 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
iFrame payment form:
Requirements
The extension has been tested to work with the following software versions:
- WordPress 5.2.X and above (tested up to 5.2.2)
- 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:
support.every-pay.com
Suggested installation and update of EveryPay plugin is using GitHub Updater plugin:
-
- Download the latest version from EveryPay Merchant support page.
- Install plugin from ZIP file via WordPress plugin manager.
- Go to ‘WooCommerce’ > ‘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 `languages` directory or
with WPML’s String Translation.
Configuration
Once the plugin is activated configuration options for EveryPay gateway can be found in WordPress admin under ‘WooCommerce’ -> ‘Settings’ -> ‘Payments’ -> ‘EveryPay’.
Due to the reason that some of the banks do not support 3DS inside the iFrame we recommend to set up redirect payment flow.
Callback notification set up in merchant portal
Callback notifications are used to inform updated status of the payments. When the payment
is finalized by a customer notification is sent to the callback_url. Notifications include
payment_reference and order_reference.
You can set callback URL in Merchant Portal under E-shop settings.
| Field name |
Description |
| Enable/Disable |
Activate EveryPay payment gateway as an option in the checkout |
| Gateway URL |
LIVE – live/production mode (payments are sent to EveryPay production server).
TEST – test mode (payments are sent to EveryPay test/demo server). |
Callback Notification
URL |
Add this URL to Callback Notification URL in EveryPay merchant portal under eshop settings |
API username / test API
username |
Everypay Production(Live) and Test servers have different API credentials.
API settings are defined in EveryPay Merchant Portal
PRODUCTION(LIVE):
https://portal.every-pay.eu/merchant_settings/general
TEST:
https://mwt-demo.every-pay.com/merchant_settings/general
Looks like this (16 symbols): 68d9463b47d9a364 |
API secret /test API
secret |
Everypay Live and Test servers have different API credentials.
API settings are defined in EveryPay Merchant Portal
LIVE: https://portal.every-pay.eu/merchant_settings/general
TEST:
https://mwt-demo.every-pay.com/merchant_settings/general
Looks like this (32 symbols):
53bac7aa8131d21671b6f2fb15de2ce4 |
| API Account Name |
Processing accounts are defined in EveryPay Merchant Portal.
LIVE:
https://portal.every-pay.eu/merchant_settings/currency_facilities
TEST:
https://mwt-demo.every-pay.com/merchant_settings/currency_facilities
Looks like this: EUR3D1 or USD3D1 |
Update Payment
Methods |
Can update payment methods manually. |
| Title of card Payment |
This controls the title which the user sees on card payments. |
| Title of Bank Payment |
This controls the title which the user sees on bank payments. |
Title of Alternative
Payment |
This controls the title which the user sees on alternative
payment methods (PayPal etc). |
Payment Integration
Variants |
Select “Redirect to hosted form on EveryPay server” to
delegate most of the security to EveryPay or “iFrame payment form
integrated into checkout” to show payment form inside your
checkout flow and provide a more user-friendly shopping
experience. Using SSL (https://) is strongly advised for iFrame
form as user expect see green padlock on browser’s address
bar when entering private information. |
| Default country |
By default country selection is attempted by the currently active locale. When some country is selected it ignores the language and shows always the selected country open banking payment method first. |
| Skin name |
(when iFrame has been selected) Specifies iFrame form
the appearance that can be configured in EveryPay merchant
portal. |
| Saved cards |
Enables one-click-payments which allows returning customers
to save their card details (a reference token to the required card
information in EveryPay system) for faster and easier payments
in the future |
| Debug Log |
Allows logging of payment process steps in detail. Transactions
are logged always. |
Version history:
| Date |
Change |
| 06.01.2021 |
New version: 1.3.4
Fix for sent_for_processing status. |
| 01.03.2021 |
New version: 1.3.6
Added possibility to upload plugin using Multisite.
Fix: Shop shows incorrect payment status in case of some settled payments. Removed 10-minute time limit for payment links on plugin side. |
| 28.04.2021 |
New version: 1.3.7
Fix: Show only one payment status for the customer. |