ZEN plugin documentation
Go to zen.comGo to myZEN.com
Documentation
  • Checkout integration
  • API business
  • API reference
  • Merchant panel
Brandbook
Go to zen.comGo to myZEN.com
Documentation
  • Checkout integration
  • API business
  • API reference
  • Merchant panel
Brandbook
  1. Magento 2.3.x - 2.4.x
  • About ZEN
    • First steps with ZEN
    • Who we are
    • What we provide
    • How we provide
  • Introduction
    • Definitions
    • About ZEN e-commerce plugins
    • Revenue streams
    • Environments
    • Authorization & authentication
    • Payment methods
    • Payment process
    • Currencies
    • Languages
  • Account registration & configuration
    • Before you begin
    • Registration
    • Configuration
    • Merchant’s panel
    • Payments setup
    • Locating Transactions in my.zen.com
    • Finding settlements
  • Features
    • Available features
    • 3-Domain Secure (3DS)
    • Authorization fee
    • Card widget
    • Cashback
    • Currency Conversion Service
    • Instant Payment Notification (IPN)
    • Shop logo on ZEN checkout
  • Integration
    • Before you begin
    • Integration checklist
    • Magento
      • Magento 2.3.x - 2.4.x
        • Features
        • Manual
      • Magento 2.0.x - 2.2.x
        • Features
        • Manual
      • Magento 1.9.x
        • Features
        • Manual
    • Opencart
      • Opencart 3.x
        • Features
        • Manual
      • Opencart 2.3.x
        • Features
        • Manual
    • OsCommerce
      • OsCommerce 1.x
        • Features
        • Manual
    • Prestashop
      • Prestashop 8.x
        • Features
        • Manual
      • Prestashop 1.7
        • Features
        • Manual
      • Prestashop 1.6
        • Features
        • Manual
    • WooCommerce
      • WooCommerce 8.9.x
        • Features
        • Manual
      • WooCommerce 6.0.x - 8.8.x
        • Features
        • Manual
    • Shoper
      • Features
      • Manual
    • ZenCart
      • ZenCart 2.x
        • Features
        • Manual
  1. Magento 2.3.x - 2.4.x

Manual

magento.jpg
NOTE
Plugin file to download: click here
WARNING
This manual is intended solely for the Magento versions 2.3.x. - 2.4.x. Before the installation please ensure you are using the appropriate version.
Plugin installation & activation
1
Download the plugin
Download the latest version of ZEN.COM plugin dedicated for Magento 2.4.x from the link embedded above.
2
Log in to your hosting
Log in to your Magento shop hosting and go to app/code catalogue.
3
Upload the plugin
Upload ZEN.COM plugin dedicated for Magento 2.4.x to the catalogue and execute the unzip command.
4
Execute the commands
Go to the root directory and execute commands listed below:
unzip -o -d app/code/Zen/Payment zen-*.zip && rm zen-*.zip
bin/magento module:enable Zen_Payment
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento cache:flush
Plugin configuration
1
Log in to your Magento admin panel
2
Start the configuration
Go to Stores and click Configuration.
3
Go to Payment methods
In the Configuration menu view, scroll to the Sales menu, click to expand it, and then go to Payment Methods.
4
Choose the Store scope
A single website can have multiple stores, each with its own main menu. The stores share the product catalog, but can have a different selection of products and design or ZEN.COM Payment plugin configuration. Please choose the store scope you would like to manage.
store scope.jpg
5
Go to ZEN.COM payments
In the Payment Methods menu view, scroll to the Other Payment Methods, click to expand it, and go to ZEN.COM payments
zen_1.jpg
6
Set the plugin enabled
Set Enabled option to “Yes” and enter the position of the Payment providers (recommended 1).
7
Enter the credentials
Enter your authentication credentials.
8
Manage terms and conditions bar
You can choose whether you want the Payment terms and conditions to be displayed within the plugin on you Shop's front end. By default, this option is enabled, ensuring that ZEN.COM's Payment terms are displayed in your Shop. To disable this function please swipe the related toggle button left (do not recommended).
9
Configure Payment methods
Payment methods / channels displaying
Payment methods / channels renaming
Payment methods / channels positioning
Payment methods / channels promoting
10
Payment channels presenting options
The Payment channels presenting options involves settings for redirecting to the ZEN.COM checkout or embedding Payment methods directly within the Merchant's service (the whitelabel option). To change each setting simply swipe the related toggle-button right and save the changes.
zen_3.jpg
INFO
Embedding Payment methods directly in the Merchant's Shop, without redirection to external sites such as ZEN.COM checkout, cards external page, or Blik hosted page, simplifies the Payment process, making it quicker and more intuitive for the Customer.
If the first toggle button is enabled, your Customers will be redirected to the ZEN.COM checkout. If not – all available Payment methods will be displayed in your shop as groups, where each Payment method contains also related Payment channels.
It is also possible to specify whether the ZEN.COM card widget should be displayed on the Merchant's service or during card Payment Customer should be redirected to the ZEN.COM hosted checkout page. If the second toggle button is enabled, card widget will be displayed during payment process directly in your Shop without redirecting to our checkout page.
You can decide whether the Customer will enter the Blik T-6 authorization code directly in your Shop page or after being redirected to the Blik service. If the third toggle button is enabled, your Customers will be redirected to Blik external page to enter the T-6 authorization code.
INFO
Please note that redirection to ZEN.COM checkout option excluding cards Payment and Blik if these are set as the whitelabel version.
11
Set up the redirection page
Using the Redirect page option, you can decide which URL your Customer will be redirected to after completing a purchase in your Shop. Simply enter the URL of the page you want your Customer to be redirected to in the Redirect page section – for example, https://www.zen.com.
redirect page.jpg
12
Save the configuration
Click Save config button to confirm and save the configuration
INFO
If the ZEN.COM Payment option is not visible or does not display correctly in your Shop, follow these steps:
1
Log in to your Magento admin panel.
2
Manage the cache
Go to System and in Tools menu click Cache Management option.
3
Select all cache
In Mass action menu select all cache
all cache.png
4
Refresh
From Actions choose Refresh
refresh.png
5
Click submit button
6
Click Flush Cache Storage button
7
Flush Magento Cache button
Found a bug in our Magento plugin? Report it to our team!
Please read the instructions below to properly prepare the bug report you will send us.
How to report a bug
Modified at 2025-06-17 08:12:59
Previous
Features
Next
Features