Nexi Merchant Setup

You can board a Nexi merchant via the Gateway Manager or an API.
Boarding a Merchant via the Gateway Manager
Before boarding a Nexi merchant in the Gateway Manager, you must have this information available:
  • The individual merchant numbers for Mastercard, Maestro, and Visa.
  • Terminal IDs: In order for you to use the terminal IDs during merchant boarding, Nexi must activate your terminal IDs. Talk to your account manager to get the terminal IDs activated.
When you have the required information available, follow these steps to board a merchant:
  1. Open the merchant account in the Gateway Manager.
  2. Select
    Attach processing path
  3. For the clearing institute, select
    and enter the required information.
  4. To finish the set up, select
    Attach processing path
Boarding a Merchant via an API
Follow these steps to use the
API to create a merchant that can process payments using Nexi. These steps also provide instructions about how to assign a card reader to the merchant and how to generate a merchant secret key for the new merchant. You will use the merchant information that Nexi provides to you to create a new merchant.
1. Create a merchant with
as the processing path.
Try it out!
{ "processingPaths": [ {
: [ "EUR" ], "schemes": [ "VISA", "MASTER", "MAESTRO", "VISAELECTRON", "UNION_PAY", "JCB", "DINERS", "DISCOVER" ], "details": { "institute": "CONCARDIS",
: [ "71E29108", "71E29109" ],
: [ { "schemes": [ "MASTER" ], "vuNummer": "153442414" }, { "schemes": [ "MAESTRO" ], "vuNummer": "353442412" }, { "schemes": [ "VISA","VISAELECTRON" ], "vuNummer": "143442416" }, { "schemes": [ "DINERS","DISCOVER" ], "vuNummer": "577777776" }, { "schemes": [ "UNION_PAY" ], "vuNummer": "487777776" }, { "schemes": [ "JCB" ], "vuNummer": "537777776" } ] },
: "ConCardis EUR" } ], "readers": [],
: "Test Merchant #42",
:{ "publicName":"Public Merchant Name", "address":"42 Merchant Street", "zip":"123456", "city":"Merchant City", "country":"DE", "contact":"+49 (170) 1234567" } }
Using the merchant information provided to you by Nexi, enter these parameters:
Provide the currency for which you want to process payments. The value is typically
Provide all the activated terminal IDs that you received from Nexi. Each active reader must have one terminal ID. In this parameter, you can use as many active readers at the same time as you have specified terminal IDs.
Provide the merchant numbers for the schemes that you received from Nexi. These are the merchant number prefixes for the three schemes:
  • Visa/Electron/Vpay merchant number starts with
  • Mastercard merchant number starts with
  • Maestro merchant number starts with
Provide a unique name for the processing paths. The recommendation is to use
and the currency for this parameter value.
Provide a unique name for each merchant that you create on the platform.
For the payment receipt, you must provide this information about the merchant:
  • Public name
  • Address
  • Contact phone number/email address
After successfully creating the merchant, you will receive a
in the response message:
{ "status": "ok", "data": { /*...*/
"identifier": "74b47dcd-45b0-4c65-a4d1-afd4aae32708"
, "name": "Test Merchant #42" /*...*/ } }
2. Find the card reader that you want to assign to the merchant.
The platform tracks all of the card readers that you purchased. In order to assign a reader to the new merchant you created in step 1, you must know its
. Use this API to find the
of a reader based on its serial number (e.g., 999-100001):
Try it out!
You will receive the
in the response message:
{ "status": "ok", "data": [{ /*...*/
"identifier": "0665ede3-3990-4c9b-beac-77abfeda5858"
, "model": "MIURA_SHUTTLE", "details": { "serialNo": "999100001" /*...*/ } }] }
3. Assign the card reader to the new merchant.
Using the
(step 1) and
(step 2), you can now assign the card reader to the merchant:
Try it out!
4. Generate the merchant secret key.
You can also generate a merchant secret key for the merchant using the API:
Try it out!
You will receive the
(merchant secret key) in the response:
{ "status": "ok", "data": { "status": "ACTIVE",
"key": "9pCcTI2mzUbLKoCdezVBowhv0b6gGwoo"
} }