Zen

This guide will walk you through the process of activating Zen.com with NORBr.

Step 1: Contract signature

Sign a contract with Zen, and get access to the back office.

Step 2 : Whitelist the following IP addresses with the support

The list of IPs to be white-listed for payment processing:

35.187.87.157

104.155.105.192

34.142.100.23

34.107.34.143

34.65.142.211

34.89.124.165

34.107.126.251

34.65.230.239

34.78.205.229

Step 3 : Connect and retrieve your API credentials

  1. Connect to the following platform for production : https://my.zen.com/ui/auth/challenge
  2. Go to your store by clicking on the name next to the basket icon.
  3. Navigate to Settings tab as shown:
  1. Retrieve the Terminal Api Key.

Step 4: Add a Merchant Contract to your Payment Network

  1. Log into your Merchant Account.
  2. Navigate to: Payment Network → Service Providers → Payment Providers → Add a Partner
  3. From the drop-down list, select Zen.
  4. Give your contract a name for easier identification: eg. PSP name.
  5. Setup general setting and fill in the credentials you earlier retrieved.
  • Merchant Contract ID will populate automatically.
  • Settlement currency: select from the drop-down menu. You will only see the available ones.
  • Select sales channel.
  • Authentication and Risk Assessment: leave without changes.
  • Connection settings: fill in the credentials you retrieved and fill in the descriptor.
  • To activate the contract set the status to active.

Step 4: Activate payment methods

Once you set up the connection by creating the Merchant Contract, you will be able to activate payment methods available for this Partner.

In the settings of your Merchant Contract where you earlier filled in the credentials and put other settings in place, you will see a section Payment Methods with two sub-sections: Active and Available.

Please note that some payment methods will require additional action before you can activate them: ApplePay - ApplePay Certificate, GooglePay - your Merchant ID.

Depending on the integration type you use, there might be differences in activating ApplePay. Please reach out to get to know the steps in our use case. You will need to do one of the following:

  • you will need to provide us with the Payment Processing Certificate from the Partner and we will follow up wit the setup.
  • fully configure ApplePay yourself using your Apple Developer Account

Step 5: Apple Pay Reference for ZEN

Please visit ZEN reference for integrating ApplePay here.

For testing

4111 1111 1111 1111

4242 4242 4242 4242

use these two numbers with any combination of cvc and a future date for expiry