To activate a terminal, the required information is provided within the request body as shown below.
curl -X 'POST' \
'https://dev-eis-api.mra.mw/api/v1/onboarding/activate-terminal' \
-H 'accept: text/plain' \
-H 'Content-Type: application/json' \
-d '{
"terminalActivationCode": "ABCD-EFDC-GSHH-RT45",
"environment": {
"platform": {
"osName": "Windows 11",
"osVersion": "Windows 11",
"osBuild": "11.901.2",
"macAddress": "00-00-00-00-00-00"
},
"pos": {
"productID": "MRA-desktop/{guid}",
"productVersion": "1.0.0"
}
}
}'
|
In addition to the Terminal Activation Code passed as Terminal A ctivation Code, the request will also carry details of the environment and Point of Sale System being used.
Json Path
|
Natural Name
|
Data Type
|
Restrictions
|
Comments
|
$.terminalActivationCode
|
|
String
|
- Mandatory - Max Length 50
|
Taxpayers will be given this code from MRA EIS Portal upon successful terminal acquisition process.
|
$.environment.platform.osName
|
OS Name
|
String
|
- Mandatory - Max Length 50
|
|
$.environment.platform.osVersion
|
OS Version
|
String
|
- Mandatory - Max Length 50
|
|
$.environment.platform.osBuild
|
OS Build
|
String
|
- Optional - Max Length 50
|
|
$.environment.platform.macAddress
|
|
String
|
- Mandatory - 17 Charecters
|
eg 01-23-45-67-89-AH
|
$.environment.pos.productID
|
Product ID
|
String
|
- Mandatory
- Max Length 50
|
Unique product identifier issued to POS Developers when their terminal software approved as compliance to MRA EIS API protocol. During development a test product ID can be requested from MRA.
|
$.environment.pos.productVersion
|
Product Version
|
String
|
- Mandatory - Max Length 50
|
Terminal Software Version.
|