Plugin integration

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

Plugin integration between Zen and e-commerce platforms involves implementing additional plugins in the e-commerce system, enabling online payments using various payment methods supported by Zen. It provides a smooth payment process for customers of the integrated store.

The plugin integration process typically involves several steps:

  1. Plugin installation: Initially, you need to install the appropriate plugin for the selected payment gateway in your e-commerce store on the e-commerce platform, such as Shoper.
  2. Configuration: Next, you need to configure the plugin by entering necessary data, such as API keys, merchant account identifiers, etc., to enable communication between the e-commerce platform and the payment gateway.
  3. Testing: After configuring the plugin, it’s advisable to conduct test payment transactions to ensure that the integration works correctly and payments are processed as expected.
  4. Deployment: Upon successful completion of integration tests, you can deploy the plugin on your e-commerce store and start accepting online payments from customers.

 

Before you begin

  • Log in to your ZEN panel and select the Store settings option from the main menu.
  • 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.
  • 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.

  • 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.
  • 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.
  • Go to the Sales tab on the left and select Payment methods. In Payment methods, click on the ZEN bar to extend it.
  • 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.
  • 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

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

Enabling ZEN payments in your store

  • In the Payments tab, click the blue Edit button and change the status to ENABLED.
  • 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.  
  • From the list of payment modules, choose ZEN and click Install module on the right.
  • 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

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

Enabling ZEN payment in your store

  • On the Payment page, when the ZEN option is selected, click Edit on the right.
  • 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

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

Enabling ZEN payments in your store

  • 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).
  • 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.  
  • 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

  • First, download the plugin file.
  • Next, log in to your Prestashop administration panel and go to Modules in the Improve tab. Then, select the Module manager option.
  • 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

  • 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).
  • 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

Before you begin

To initiate a connection between ZEN.COM Payment system and Shoper, you need to enable Shoper integration feature in your my.zen.com Merchant panel, create your individual password for each terminal connection and copy your Shoper integration code block. To do so:

1. Log in to your my.zen.com Merchant panel

2. Go to Store settings

    Open the menu and go to Store settings.

    3. Enable Shoper integration

    Go to Settings page and scroll down to Other settings section. Swipe Shoper integration toggle button to enabled.

    4. Enter your Shoper data

    Enter your Shoper Shop individual URL. Ensure to use https:// before the main address of your Shop – e.g. https://your-shoper-store-url.pl. Then create a password that you will use to secure communication between ZEN.com and Shoper and enter it in the Password field. Remember this password – you will need this password in the next steps of the integration. Click Save button.

    5. Copy your Shoper integration code

    Click Copy button to copy your individual Shoper integration code. You will need this code in the next steps of the integration.

    ZEN.COM Payment configuration in the Shoper admin panel

    1. Log in to your Shoper admin panel

    Log in to the Shopper Admin panel. To do so, type in your browser: your-store-url/admin . For example www.myshopperstore.com/admin.

    2. Go to Store administrators menu

    In the main menu, go to Settings > General > Store administrators.

    3. Create the new administrator group

    Click More and from the drop-down menu select Add administrators group to create the new administrator group.

    4. Add administrators group

    Type webapi to Name field, add your description in the Description field and choose access to webapi from the drop-down Access type menu. Click Save button.

    5. Change the Sales and Configuration permissions

    Go to the Permissions settings and apply the following changes:
    Sales: read, add, edit, delete
    Configuration: read
    Click Save button.

    6. Add the administrator

    Now, go to the Administrator tab and click Add an administrator to add a new ZEN user.

    Use the following data:

    • First and last name: Zen
    • Login: Zen
    • E-mail: [email protected]
    • Group: webapi
    • Password: use your password created in my.zen.com Merchant panel to secure communication between the ZEN.COM and the Shoper (Step 4 in section Before you begin)
    • Repeat password: as above

    Click Save button.

    Configuring payments

    1. Add ZEN.COM payment methods

    In the Shoper Admin panel, go to Settings > Order processing > Payment methods and click Add payment method button.

    2. Configure ZEN.COM payment method

    Fill in the form with the following data:

    • Payment type: external – untrasted
    • Name: ZEN.COM
    • Description: Online payments
    • Activity: swipe to „on” position
    • Choose all supported currencies in your Shop by clicking the corresponding checkbox.

    Scroll down the page to the Message after placing an order section. Click disable editor button to enable coding mode.

    Paste the Shoper integration code block from my.zen.com Merchant panel (Step 5 in section Before you begin) and click Save button.

    Configuring shipping methods

    1. Go to Shipping methods

    In the Shoper Admin panel, go to Settings > Order processing > Shiping methods to see all shipping methods integrated with the Shop.

    2. Add ZEN.COM Payments to your shipping methods

    Click Action button corresponding to the shipping method for which you want to add ZEN.COM Payments. From the drop-down menu choose Edit option.

    In new window scroll down to the ZEN.COM Payment method and check the checkbox to activate it. Then click Save button.

    3. Repeat the procedure for the remaining shipping methods.

    Follow the procedure described in step 2 for each shipping method for which you want to enable ZEN.COM Payments.

    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

    • First, download the plugin file.
    • Next, log in to your WooCommerce administration panel and select the Add new option from the Plugins tab on the left. 
    • 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.
    • Once the plugin has been installed, click the Activate plugin button.

    Enabling ZEN payments in your store

    • From the Woocommerce tab on the left, select the Settings option. Then, go to the Payments tab.
    • On the list of payment options, find ZEN and make sure the switch button is turned ON.
    • Now, click the Manage button.
    • 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.  
    • 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.

    • First, download the plugin file.
    • Then, go to your hosting site and extract the downloaded zip file under the ZenCart folder.
    • Now, log in to your ZenCart administration panel, and select Modules > Payment from the top bar.
    • From the list of payment modules, choose ZEN and click Install Module on the right.
    • 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.