Plugin integration

The below plugins are a quick way to easily integrate ZEN payment solutions into your store.

 

Before you begin

  1. Log in to your ZEN panel and select the Store settings option from the main menu.
  2. Next, go to the Payment methods page and select payment methods which you would like to enable in your store's checkout.
    Note: For a multiple-Terminal setup, please make sure to select the desired Terminal from the dropdown list.
  3. Now, locate your integration credentials. See how to get integration credentials.

 

Once you have all the required credentials, select the desired plugin for your e-commerce platform from the list.

 

Magento

Follow the below instructions to integrate ZEN payment solutions with Magento.

 

  1. First, download the plugin zip file for an appropriate Magento version and extract it:
    1. Magento 1.9 
    2. Magento 2.3
    3. Magento 2.0
  1. Then, go to your hosting site. Take the app and skin folders from the extracted zip file and replace the existing ones in the Magento folder.
  2. Now, log in to your Magento administration panel, and in the System tab (for Magento 1.9) or in the Stores tab (for Magento 2.0 and 2.3), select the Configuration option.
  3. Go to the Sales tab on the left and select Payment methods. In Payment methods, click on the ZEN bar to extend it.
  4. Now, fill in integration credentials (Terminal UUID, Paywall secret, Terminal API key, and IPN secret).See how to get integration credentials.
    Note: The Payment title will be visible on the payment page describing ZEN payment methods to your customers. It is filled in by default but you can change it according to your preferences.
  5. Finally, select the currencies that will be accepted in your store.

To save the configuration, click on the Save config button on the top right.

 

Opencart

Follow the below instructions to integrate ZEN payment solutions with Opencart.

Installing the ZEN plugin on Opencart

  1. First, download the plugin file for an appropriate Opencart version and extract it:
    1. Opencart 2.3
    2. Opencart 3
  2. Next, go to your hosting site and extract the downloaded file under the main shop folder.
  3. Now, log in to your OpenCart administration panel.
  4. In the panel, select the Extensions option from the navigation panel on the left. Then, select Payments from the drop-down menu.
  5. Next, click the green Install button on the right, next to the ZEN option.

Enabling ZEN payments in your store

  1. In the Payments tab, click the blue Edit button and change the status to ENABLED.
  2. Next, fill in integration credentials (Terminal UUID, Paywall secret, Terminal API key, and IPN secret). See how to get integration credentials.
    Note: The Payment title will be visible on the payment page describing ZEN payment methods to your customers. It is filled in by default but you can change it according to your preferences.  
  3. From the list of payment modules, choose ZEN and click Install module on the right.
  4. Finally, select the currencies that will be accepted in your store.

To save the configuration, click on the Save button on the top right.

 

OsCommerce

Follow the below instructions to integrate ZEN payment solutions with osCommerce.

Installing the ZEN plugin on osCommerce

  1. First, download the plugin file.
  2. Next, log in to your osCommerce administration panel, and from the Module tab on the left, select the Payment option.
  3. On the top right, click the Install module button. Then, select the ZEN option. 
  4. Once the ZEN option has been selected, click on the Install module button on the right.

Enabling ZEN payment in your store

  1. On the Payment page, when the ZEN option is selected, click Edit on the right.
  2. Now, fill in integration credentials (Terminal UUID, Paywall secret, Terminal API key, and IPN secret). See how to get integration credentials.

Once you have completed all the fields, click Save to finish the configuration process.

 

Prestashop 1.6

Follow the below instructions to integrate ZEN payment solutions with Prestashop 1.6.

Installing the ZEN plugin on Prestashop 1.6

  1. First, download the plugin file.
  2. Next, log in to your Prestashop administration panel and select Modules and services on the left.
  3. Click the Add a new module button on the top right and upload the zip file.
  4. Find the ZEN module on the list of modules and click the Install button on the right.

Enabling ZEN payments in your store

  1. Once the plugin has been installed, you will be redirected to the configuration site.
    (You can configure your plugin later by clicking on the Configure button next to the ZEN module).
  2. Now, fill in integration credentials (Terminal UUID, Paywall secret, Terminal API key, and IPN secret). See how to get integration credentials.
    Note: The Payment title will be visible on the payment page describing ZEN payment methods to your customers. It is filled in by default but you can change it according to your preferences.  
  3. Finally, select the currencies that will be accepted in your store from the dropdown list. To select more than one at once, press and hold the Ctrl button while selecting currencies. 

Once you have completed all the fields, click Save to finish the configuration process.

 

Prestashop 1.7

Follow the below instructions to integrate ZEN payment solutions with Prestashop 1.7.

Installing the ZEN plugin on Prestashop 1.7

  1. First, download the plugin file.
  2. Next, log in to your Prestashop administration panel and go to Modules in the Improve tab. Then, select the Module manager option.
  3. Click the Upload a module button on the top right and upload the zip file.

The module will be installed automatically.

Enabling ZEN payment in your store

  1. First, click Configure right after the module has been installed.
    (You can also do it later by selecting the ZEN Payment method in the Module Manager).
  2. Next, fill in integration credentials (Terminal UUID, Paywall secret, Terminal API key, and IPN secret). See how to get integration credentials.
    Note: The Payment title will be visible on the payment page describing ZEN payment methods to your customers. It is filled in by default but you can change it according to your preferences.  

Once you have completed all the fields, click Save to finish the configuration process.

 

Shoper

Follow the below instructions to integrate ZEN payment solutions with Shopper.

Enabling ZEN payments in Shopper Admin panel

  1. Log in to the Shopper Admin panel. To do this, open the following link in your browser: <your-store-url>/admin . For example www.myshopperstore.com/admin .
  2. In the main menu, go to Settings > General > Shop Administrators.
  3. In Shop Administrators, create a new Administrator group and name it webapi. For its access type, select webapi access. Then click Save to finish creating the group.
  4. Next, go to permissions settings and apply the following changes:
    Sales: read, add, edit, delete
    Configuration: read
  5. Now, go to the Administrator tab and add a new ZEN user with the following data:
    Firstname and lastname: Zen
    Login: Zen
    E-mail: webapi@zen.com
    Group: webapi
    Password: enter your password that will be used for ZEN checkout
    Repeat password: as above

Connecting Shoper store with ZEN

To connect your Shoper store with ZEN, please contact us and provide us with:

  • your store's URL address
  • the password which you have set up in the previous steps
  • terminalUUID, which you can find in the Credentials chapter.

 

Once we have connected and configured your account, we will send you a confirmation message containing a code block. Save it as you will need it in the next step.

Configuring payments

To configure payments:

  1. In the Shoper Admin panel, go to Settings > Order settings > Payment methods.
  2. Click on the Add payment button and fill in the form with the following data:

    Payment type: external - not trusted
    Name: ZEN
    Active: yes
    Currencies: (chose currencies used on your store)
  3. Now, replace the content of the source code with the code block provided by us.
  4. Finally, go to Settings > Order settings > Delivery methods, and enable ZEN for Specific methods.

Exceptions and limitations

Please note that Shoper platform does not feature refunds for their external plugins. Hence, each refund must be processed manually both in ZEN and Shoper.



So every time you would like to make a refund, please make sure it is done in BOTH:

 

  • Shoper Admin panel
  • ZEN panel, in the Payments section.

 

If you only process a refund on Shoper's side, the money will not be transferred back to the customer. You must complete the refund process in the ZEN panel in order to return the money.

 

WooCommerce

Follow the below instructions to integrate ZEN payment solutions with WooCommerce 3.0 and higher.

Installing the ZEN plugin on WooCommerce

  1. First, download the plugin file.
  2. Next, log in to your WooCommerce administration panel and select the Add new option from the Plugins tab on the left. 
  3. Now, click the Upload plugin button at the top and select Choose file. Then, select the downloaded zip file from your computer and click Install now.
  4. Once the plugin has been installed, click the Activate plugin button.

Enabling ZEN payments in your store

  1. From the Woocommerce tab on the left, select the Settings option. Then, go to the Payments tab.
  2. On the list of payment options, find ZEN and make sure the switch button is turned ON.
  3. Now, click the Manage button.
  4. Fill in integration credentials (Terminal UUID, Paywall secret, Terminal API key, and IPN secret). See how to get integration credentials.
    Note: The Payment title will be visible on the payment page describing ZEN payment methods to your customers. It is filled in by default but you can change it according to your preferences.  
  5. Finally, select the currencies that will be accepted in your store.

To save the configuration, click on the Save changes button.

 

ZenCart

Follow the below instructions to integrate ZEN payment solutions with Zencart.

  1. First, download the plugin file.
  2. Then, go to your hosting site and extract the downloaded zip file under the ZenCart folder.
  3. Now, log in to your ZenCart administration panel, and select Modules > Payment from the top bar.
  4. From the list of payment modules, choose ZEN and click Install Module on the right.
  5. Now, fill in integration credentials (Terminal UUID, Paywall secret, Terminal API key, and IPN secret). See how to get integration credentials.

Once you have completed all the fields, click Update to save the configuration.