Terminal Activation

NOTE: This is only done once when setting up your device

Terminal Activation is a one-time process performed when setting up a new fiscal device.
It establishes trust between the POS terminal and the MRA EIS system by exchanging an Activation Code for terminal credentials and configuration data.

The activation process consists of two main steps:

Terminal Activation (Initiation)
Terminal Activation Confirmation (Finalization)

Once completed, the terminal is fully authorized and ready for fiscal operations.

Prerequisites

Before starting terminal activation, ensure that:

The taxpayer has successfully acquired a terminal via the MRA EIS Portal
A Terminal Activation Code (TAC) has been issued by MRA
The terminal has internet access
This process is only performed once per terminal

Terminal Activation (Initiation)

This endpoint initiates the activation process by submitting the Terminal Activation Code (TAC) along with terminal environment details.

Authentication Management

Get Credentials:
GET /api/terminalactivation/credentials — Retrieves stored IDs and tokens.
Set Token:
POST /api/terminalactivation/set-token — Manually updates the Bearer token if required.

Initialize

Endpoint

POST /api/v1/onboarding/activate-terminal

Base URL

https://dev-eis-api.mra.mw

Request Parameters

Field	Description
terminalActivationCode	Activation code issued by MRA

Request Body

JSON

{ "terminalActivationCode": "9ZQZ-PGZT-8E2Z-TS7I", }

Response

JSON

{
{
  "statusCode": 1,
  "remark": "Terminal Activated, pending for confirmation request",
  "data": {
    "activatedTerminal": {
      "terminalId": "70e1dc1c-6f02-45af-bfb4-d65b6e813d4b",
      "terminalPosition": 44,
      "taxpayerId": 12,
      "activationDate": "2025-11-20T09:12:17.6435474+02:00",
      "terminalCredentials": {
        "jwtToken": "eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9...",
        "secretKey": "d85d26e6400859244ce3987445ad13df950095b"
      }
    },
    "configuration": {
      "globalConfiguration": {
        "taxrates": [
          {
            "id": "A",
            "name": "Standard Rated",
            "rate": 16.5
          },
          {
            "id": "B",
            "name": "Zero Rated",
            "rate": 0
          }
        ]
      },
      "terminalConfiguration": {
        "terminalLabel": "MJ01",
        "isActiveTerminal": false,
        "emailAddress": "developers@axissol.com"
      },
      "taxpayerConfiguration": {
        "tin": "20234308",
        "isVATRegistered": true
      }
    }
  },
  "errors": []
}

}

Important Notes

After a successful activation response:

✅ Persist the following securely:

terminalId
jwtToken
secretKey
Terminal, taxpayer, and tax configuration data

Terminal Activation Confirmation

Once all configuration data has been successfully stored on the terminal, a confirmation request must be sent to MRA.

This step:

Flags the terminal as fully activated
Invalidates the Terminal Activation Code (TAC)
Enables live fiscal operations

Endpoint

POST /api/v1/onboarding/terminal-activated-confirmation

Base URL (Test Environment)

https://dev-eis-api.mra.mw

Request Body

{
  "terminalId": "70e1dc1c-6f02-45af-bfb4-d65b6e813d4b"
}

## Response

{
  "statusCode": 1,
  "remark": "Terminal is now fully activated and ready for use!",
  "data": true,
  "errors": []
}