PrestaShop extension. Merchant Integration Manual
18.04.2022
Features
- Adds EveryPay payment gateway service to the PrestaShop 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 card payment form:
Open Banking payment (always redirect)
Requirements
The extension has been tested to work with the following PrestaShop versions:
- PrestaShop v1.6.1.8
- PrestaShop v1.7.6
The extension does not work with PrestaShop v1.7.0.3!
Installation
EveryPay extension is available on EveryPay Support website free of charge:
support.every-pay.com
1. Go to the Back Office and open “Modules” > “Module manager” from main menu
2. In the upper right corner of the screen locate the button “Add new module”.
3. Upload the ZIP file
4. Locate the EveryPay module in the list, scrolling down if necessary.
5. In the row for the new module, click Install.
6. Locate the module and click > Configure.
Configuration
Once the module is activated configuration options for EveryPay can be found in PrestaShop admin interface under “Modules” > “Module manager” > “EveryPay”.
| Field name |
Description |
| Live Mode |
On – module uses Live server, Off – module uses test server (this is for testing only- then Test API Username and Test Shared secret are in use) |
| Token Payments |
Enables one-click-payments which allows returning customers to save their card details (a reference token to required card information in EveryPay system) for faster and easier payments in the future. |
| Payment form type |
iFrame – payment form is embedded in the checkout workflow
Redirect – after checkout the buyer is redirect to EveryPay payment
page
* Open banking payments are always redirect. |
| Description |
This controls the description which the user sees during checkout in
Payment Confirmation page. Free text in HTML-format can be added. |
| Processing Account |
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 |
| API Username/secret |
EveryPay Live and Test servers have different API credentials.
API settings are defined in EveryPay LIVE Merchant Portal:
https://portal.every-pay.eu/merchant_settings/general |
Test API
Username/secret |
EveryPay Live and Test servers have different API credentials.
API settings are defined in EveryPay TEST Merchant Portal:
https://mwt-demo.every-pay.com/merchant_settings/currency_facilities |
*Due to the reason that some of the banks do not support 3DS inside the iFrame we recommend to set up redirect payment flow.
In PrestaShop admin settings under Payment > Preferences > Country restrictions > Mark each checkbox for the country, or countries, in which you want the payment module to be available.
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. https://yourURL.com/module/everypay/return
EveryPay has two separate Merchant Portals:
● Test/demo: https://mwt-demo.every-pay.com
● Live/production: https://portal.every-pay.eu
*Please ensure that you access the correct environments.
Version history
| Date |
Change |
| 04.11.2020 |
Small bug fixes for Prestashop version 1.7:
- Show currency on payment confirmation page.
- Show correct payment method under order history.
|
| 24.11.2020 |
The first version of Prestashop 1.6 plugin.
|
| 19.11.2021 |
Bugfix for Prestashop version 1.7:
- Changed order reference source in return controller
- Added support for underpaid/overpaid orders in ‘create after’ mode
|