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.
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;  
    • Configure data collector
      Remember to configure the Fraud collector and generate a fingerPrintId.
    • Apply for PCI DSS
      To safely use card methods and ensure data security, a PCI certificate is required.
  • 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.

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

Rest of integration

Widget configuration
More information

If you use our widget, you need to test it. When you create a widget compatible with your website, you should initiate accepting payments to ensure that the integration with our system works well.  
Make a payment; Initiate the payment on your website and choose the card method. Fill in the blanks with your card data.

Dynamic Currency Conversion 

When initiating a transaction(if you have DCC services active), try switching the currency according to those displayed at the checkout, and successfully complete the transaction.