Merchant checklist

Create your account

Fill out the contact form on get.zen.com, through which a account manager will get in touch with you. Together, you will go through the onboarding process, during which you will choose the type of integration and payment methods you wish to have on your store. Decide which integration method will be suitable for you.
Think about payment method are necessary for your business and which ones your customers will most frequently use.
Ensure that you have completed all necessary steps with your account manager.
Ask the account manager about testing the account. Important information: For the test account registration, we will need information about IP address you will be using during testing.
You will receive login credentials for your test account on the my.zen-test.com platform.

Remember that credentials for the test and production accounts are different!

Starting the test

Log in to your account and review with the credentials. Important information: In the store settings you will find credentials and you should have two payment methods BLIK and Card – these are the only available methods for the test environment.

Build your integration

Starting the test

Log in to your account and review with the credentials. Important information: In the store settings you will find credentials and you should have two payment methods BLIK and Card – these are the only available methods for the test environment, refund is only available for Card method. You should receive information about the test BLIK and test card credentials for your test environment via mail along with your logs credentials.

You can find the credentials by logging into the platform at my.zen-test.com, accessing your store, and then navigating to „Store Settings”.

Test your integration

Make test payment Depending on the integration method you have chosen, whether it’s checkout or API, according to the instructions for the respective method, you need to perform a test payment. To test your integration, initiate a test payment; Your payment can be accepted or rejected Handle errored or refused payments. It is crucial to understand how the system works when a payment is declined or encounters an error. Refer to our documentation for assistance in conducting such a payment.

How to make successful payment?

Checkout

API

1. Creating a request.
2. Generating signature.
Important: Go through all the signature generation instruction points carefully, paying attention to whether the data declared in the request differs from that in the text before hashing, remembering to preserve all characters.
3. Configure IPN.
4. Test payment.
Important: To set up payment ZEN, you should POST to this ZEN test URL https://secure.zen-test.com/api/checkouts
5. Check payment on my.zen-test.com panel.

1. Creating transaction.
To create transaction you have to POST to this ZEN test URL
https://api.zen-test.com/v1/transactions
Important: In the request, there are data such as „paymentChannel” and „type”, the values of which you can check at this address
https://www.zen.com/developer/api-integration/#payment-methods
We need to remember to add in headers the API Key (from credentials) and Content-Type: application/json
2. Configure IPN.
3. Check payment on my.zen-test.com panel.

Make test refund In the plug-in and checkout integration, you can only process refunds through the my.zen-test.com platform, whereas in the API integration, in addition to processing refunds through the ZEN platform, you can also do so via a POST to the ZEN test URL https://api.zen-test.com/v1/transactions/refundAccording to our API documentation field transactionId – id of transaction to be refunded provided in ZEN, you can check value in my.zen-test.com
Check IPN configuration After a successful payment or refund, an Instant Payment Notification (IPN) with information about the payment and refund should be sent to the declared URL address. If you receive a notification after completing a test transaction, the configuration was successful.

Configure integration on production environment

Check on your zen account (my.zen.com) you have all required payment methods are visible, and you can click to activate them.
Follow our integration documentation to have the opportunity to process payments and repeat the steps from the test environment with the corresponding URL address as listed in our documentation.

Additional set up. For each type of integration, there are certain payment methods that need to be integrated additionally: Apple Pay, Google Pay or PayPal.
Make a payment. Test various payment methods in the production environment; you will have access to all configured methods.

For API integration;

Make a refund. You can perform partial and full refund, whether partial refunds are possible depends on the payment method. Partial refunds are not available for the Pay by Link method.
IPN configuration. Configure IPN in the production environment, make sure you acknowledge IPN using the HTTP protocol with a „200” status. However, if you do this incorrectly, IPNs will be sent to you queued. Check if you’re receiving all IPNs for your account.

Merchant checklist

Create your account

Starting the test

Build your integration

Starting the test

You are ready to operate and use the ZEN gateway correctly.