net-m Privatbank Merchant Setup

You can board a  net-m Privatbank merchant via the Gateway Manager or via an API.
Boarding a Merchant via the Gateway Manager
To board a net-m Privatbank merchant in the Gateway Manager, you must have this information available:
  • VP Number
  • Terminal IDs: net-m Privatbank must activate the terminal IDs you can use them. 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 in the Gateway Manager.
  2. Select
    Attach processing path
  3. For the Clearing Institute, select Select
    net-m Privatbank
    and enter the required data.
  4. To finish the setup, select
    Attach processing path
Boarding a Merchant via the API
Follow these steps to use the Platform API to create a merchant and board that can process payments using net-m Privatbank. 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 net-m Privatbank provided to you.
1. Create a merchant with net-mPrivatbank as the processing path.
{ "processingPaths": [ { "currencies": [ "EUR" ], "schemes": [ "VISA", "MASTER", "MAESTRO", "VISAELECTRON" ], "details": { "institute": "NET_M_PRIVATBANK", "terminalIds": [ "71E29108" ], "vuNummers": [ { "schemes": [ "MASTER" ], "vuNummer": "153442414" }, { "schemes": [ "MAESTRO" ], "vuNummer": "153442414" }, { "schemes": [ "VISA","VISAELECTRON" ], "vuNummer": "153442414" } ] }, "name": "Privatbank EUR" } ], "readers": [], "name": "Test Merchant #42" }
Please provide those parameters:
Provide the
in which you want to process payments. The value is typically
Provide all
Terminal IDs
that Privatbank activated for you. You can use as many active readers at the same time as you have specified terminal IDs here. Each active reader must have a terminal ID.
Provide the
VP Number
for all schemes. The VP Number you receive from Privatbank is valid for all schemes.
Specify a unique name for each merchant that you create on the platform.
We recommend always using "Privatbank" and the currency for this name.
After successfully creating the merchant, you will receive a
in the response:
{ "status": "ok", "data": { /*...*/
"identifier": "74b47dcd-45b0-4c65-a4d1-afd4aae32708"
, "name": "Test Merchant #42" /*...*/ } }
2. Find the reader you want to assign to the merchant.
The platform tracks all the readers that you purchased. In order to assign a reader to the new merchant you created in step 1, you must know the
for the card reader. 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:
{ "status": "ok", "data": [{ /*...*/
"identifier": "0665ede3-3990-4c9b-beac-77abfeda5858"
, "model": "MIURA_SHUTTLE", "details": { "serialNo": "999100001" /*...*/ } }] }
3. Assign the reader to new merchant.
Based on the
from step 1 and the
from step 2, you can now assign the reader to the merchant:
Try it out!
4. Generate the merchant secret key.
You can also generate a merchant secret key for the merchant via the API:
You will receive the merchant secret key (
) in the response:
{ "status": "ok", "data": { "status": "ACTIVE",
"key": "9pCcTI2mzUbLKoCdezVBowhv0b6gGwoo"
} }