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:
- Open the merchant in the Gateway Manager.
- SelectAttach processing path.
- For the Clearing Institute, select Selectnet-m Privatbankand enter the required data.
- To finish the setup, selectAttach 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:
- $.processingPaths.currencies
- Provide theCurrencyin which you want to process payments. The value is typicallyEUR.
- $.processingPaths.details.terminalIds
- Provide allTerminal IDsthat 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.
- $.processingPaths.details.vuNummers
- Provide theVP Numberfor all schemes. The VP Number you receive from Privatbank is valid for all schemes.
- $.name
- Specify a unique name for each merchant that you create on the platform.
- $.processingPaths.name
- We recommend always using "Privatbank" and the currency for this name.
After successfully creating the merchant, you will receive a
merchantIdentifier
in the response: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
readerIdentifier
for the card reader. Use this API to find the readerIdentifier
of a reader based on its serial number (e.g. 999-100001):You will receive the
readerIdentifier
in the response: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
merchantIdentifier
from step 1 and the readerIdentifier
from step 2, you can now assign the reader to the merchant:4. Generate the merchant secret key.
You can also generate a merchant secret key for the merchant via the API:
Request
{ "permissions": ["READER_MANAGEMENT","TRANSACTIONS"] }
You will receive the merchant secret key (
key
) in the response:Response
{ "status": "ok", "data": { "status": "ACTIVE","key": "9pCcTI2mzUbLKoCdezVBowhv0b6gGwoo"} }