There are two options for boarding a Credorax merchant: via the Gateway Manager or via the API.
Boarding via the Gateway Manager
To board a Credorax merchant in the Gateway Manager, you will need the following data:
Gateway MID
Signature Key
Terminal ID(s)
Credorax needs to activate the terminal ID(s) before they can be used. Talk to your Payworks account manager to get the terminal ID(s) activated.
MID Name (applies to Payment facilitators only)
After you have the above data:
Open the merchant in the Gateway Manager and select Attach processing path.
Select Credorax as Clearing Institute and enter the data.
If you are a payment facilitator,specify the MID Name in this format of XYZ-MerchantName. XYZ is the payment facilitator abbreviation (three digits only) that you received from Credorax, MerchantName is the name of your merchant (without spaces, up to 21 characters).
To finish the setup, select Attach processing path.
Use the following steps to create a merchant based on the
Merchant Connectivity Details
document that Credorax provided to you.Instructions are provided about how to assign a reader to the merchant and how to generate a merchant secret key for the new merchant.
1. Create a Merchant with CREDORAX as the processing path.
{
"processingPaths": [
{
"currencies"
: [
"EUR"
],
"schemes": [
"VISA",
"MASTER",
"MAESTRO",
"VISAELECTRON"
],
"details": {
"institute": "CREDORAX",
"terminalIds"
: [
"T0001222", "T0001333", "T0001334"
],
"gatewayMid"
:"ABC123",
"midName"
:"PWM-Flower Shop",
"signatureKey"
: "321tax74h9vs403e"
},
"name": "Credorax EUR"
}
],
"readers": [],
"name"
: "Test Merchant #42"
}
Based on the "Merchant Connectivity Details" document from Credorax, provide those parameters:
$.processingPaths.currencies
Provide the
Currency
as stated in the "MID Setup Details" section of the "Merchant Connectivity Details" document.
Important:
Should your "Merchant Connectivity Details" document contain multiple currencies in the "MID Setup Details" section, note that the platform currently only supports one currency per merchant. This means you need to create one merchant for each currency.
$.processingPaths.details.terminalIds
Provide all Terminal IDs from the "TID" section. Credorax usually provides 10 TIDs, which means that you can use up to 10 active readers at the same time.
$.processingPaths.details.gatewayMid
Provide the
Gateway MID
as stated in the "MID Setup Details" section. It is six characters long.
$.processingPaths.details.midName
Provide the
MID Name
as stated in the "MID Setup Details" section.
Important:
If you are a
Payment Facilitator
and you are using one of your super-merchant
Gateway MIDs
, specify the
$.processingPaths.details.midName
in this format: <PaymentFacilitatorAbbreviation>-<SubMerchantName>, e.g., "PWM-Flower Shop".Talk to your account manager if you are unsure about what you need to provide here.
$.processingPaths.details.signatureKey
Provide the
Signature Key
as stated in the "Connectivity Details" section.
$.name
Specify a unique name for each merchant that you create on the platform.
$.processingPaths.name
We recommend to always use "Credorax" and the currency for this name.
You will receive a
merchantIdentifier
after successfully creating the merchant:
{
"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 keeps track of all the readers that you have purchased. In order to assign a reader to the new merchant you have created in Step 1, you must know its
readerIdentifier
. 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:
{
"status": "ok",
"data": [{
/*...*/
"identifier": "0665ede3-3990-4c9b-beac-77abfeda5858"
,
"model": "MIURA_SHUTTLE",
"details": {
"serialNo": "999100001"
/*...*/
}
}]
}
3. Assign the reader to new merchan.
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
Try it out!
Request
{
"permissions": ["READER_MANAGEMENT","TRANSACTIONS"]
}
You will receive the Merchant Secret Key in the response:
{
"status": "ok",
"data": {
"status": "ACTIVE",
"key": "9pCcTI2mzUbLKoCdezVBowhv0b6gGwoo"
}
}