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.
post
/v2/merchants/
Request
{
  "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 the
Currency
 in which you want to process payments. The value is typically
EUR
.
$.processingPaths.details.terminalIds
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.
$.processingPaths.details.vuNummers
Provide the
VP Number
for 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):
get
/v2/readers/?serialNo=999-100001
Try it out!
Request
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:
put
/v2/merchants/{merchantIdentifier}/readers/{readerIdentifier}
Try it out!
Request
4. Generate the merchant secret key.
You can also generate a merchant secret key for the merchant via the API:
post
/v2/merchants/{merchantIdentifier}/secretKey
Request
{
        "permissions": ["READER_MANAGEMENT","TRANSACTIONS"]
}
You will receive the merchant secret key (
key
) in the response:
Response
{
    "status": "ok",
    "data": {
        "status": "ACTIVE",
        
"key": "9pCcTI2mzUbLKoCdezVBowhv0b6gGwoo"

    }
}

Related information