Merchant Setup

Merchants can be boarded via the Gateway Manager or via the API. To get started with merchant setup, create one pair of
merchantIdentifier
and
merchantSecretKey
for each merchant / user that will use your application with a card reader.
There are two ways to board merchants:
  • Boarding via the Gateway Manager, where you can add each new merchant manually. This option is recommended for adding a small numbers of merchants.
  • Boarding via the Backend API, where you can create merchants in batches or integrate the merchant creation process in to your backend by using the API.

Getting Started

You must have the following information to successfully board a merchant:
  • Merchant's name
  • Processing data from your acquirer for this merchant, usually called MID and TIDs
  • Serial number of the card reader that the merchant will use
  • Merchant's receipt data, including company name, street address, city, postal code, country, and phone number
Also check the individual requirements for each acquirer for additional information you may be required to provide.

Boarding via the Gateway Manager

To board a merchant via the Gateway Manager:
  1. Go to the merchant overview in the Gateway Manager and select Create new merchant
  2. Create a merchant by filling in all the required information, including the receipt information
  3. Attach the desired processing path by selecting your acquirer and filling in the acquirer-specific information. Make sure you use each terminal ID only once. To get started quickly on the test system, use the
    Integration Test Acquirer
  4. Attach the card reader and enter the serial number of the card reader that will be used by the merchant. See here for details
  5. Select Add merchant once you are done.

Boarding via the API

In order to create a new merchant, you need perform a series of API calls:
  1. Create a merchant with the desired processing path. A successful call will return a
    merchantIdentifier
    which you will need to use for the subsequent steps;
  2. Generate the
    merchantSecretKey
    which you will need in order to perform transactions;
  3. [Optional]: Assign a card reader to the newly-created merchant: Serial Number of the card reader that the merchant will use:
    1. Based on the reader serial number, you can find the
      readerIdentifier
      of the device you want to assign to the merchant;
    2. Finally, assign the reader to new merchant using the
      merchantIdentifier
      and the
      readerIdentifier
      .