Authorization & Authentication - ZEN API documentation

INFO

Types of Credentials you'll need to integrate with ZEN.COM using full API integration:

IPN Secret

Terminal API Key

Terminal API Key should be placed in header of your API requests.

The security of Transactions is the highest priority in the ZEN.COM Payment system. That is why all Payments using Terminal are securely encrypted. As a certified Payment Service Provider, we continuously enhance our security systems to ensure they always comply with the rigorous standards of the global financial sector.

Integration with ZEN.COM allows for authorization using an authorization token. Depends on type of integration various Credentials will be used. All API requests have to be made using the HTTPS protocol and properly authenticated - otherwise, they will be rejected by ZEN.COM.

Merchants using the my.zen.com application can view and manage credentials settings from within the app's panel.

To get your credentials:

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 Terminal sub-menu

Go to the Terminal page to check your individual Credentials. This page is divided into 7 sections:

Selection of the Terminal for which the credential details are to be displayed.

Information about the available functionalities in the selected Terminal.

Selection of credentials based on the integration type.

Option to hide/show credentials.

Preview of individual credentials for the selected Terminal.

Button to copy the selected credential.

Button to generate a new credential.

Choose your Terminal

Choose the Terminal for which you would like to review your credentials and review / copy / regenerate your credentials

DANGER

API keys have special permissions that allow access to certain functionalities or data. It's important to keep them secure because they carry the ability to perform actions or access information that regular users might not have the rights to do.

We recommend never share your API keys publicly, include them as part of your code, or pass them to unauthorized persons. If you suspect that your API keys have been exposed publicly or have fallen into the wrong hands, please go to my.zen.com Merchant panel to generate new authentication data. To generate new credentials:

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 Terminal settings menu

Click Terminal menu button to get to the section.

Choose your Terminal

Choose the terminal for which you would like to generate new credentials.

Generate new credentials

After choosing the right Terminal (1) click refresh button for each credential, to generate new ones (2).