Manual - ZEN plugin documentation

WARNING

This manual is intended solely for the Shoper platform. Before the integration please ensure you are using the appropriate platform.

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:

Click the Shop selector icon

Choose the desired Shop context

Choose the desired Shop context by clicking its name. You can scroll up / scroll down Shop listing if necessary.

Click Store settings menu

Click Store settings menu button to get to the multimenu section.

Go to Settings sub-menu

Go to the Settings page and scroll down to the Shoper section.

Choose your Terminal

Choose the Terminal for which you would like to add your Shoper integration.

Enable Shoper integration

Scroll down to Other settings section. Swipe Shoper integration toggle button to enabled.

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.

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

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

Go to Store administrators menu

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

Create the new administrator group

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

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.

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.

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

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

Add ZEN.COM payment methods

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

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

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.

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.

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.

WARNING

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.

Example of Shoper front-end payment process:

Payment method selection

Customer chooses ZEN.COM as Payment method.

Confirmation page

Customer is redirected to the confirmation page. It is possible to clikc "Pay now" button or wait 5 seconds for the redirection to the ZEN.COM checkout page.

Checkout page

Customer pays using ZEN.COM checkout page.