4.1. Onboarding
Onboarding is the process of introducing new terminals into the system.
The terminal Onboarding process starts with a taxpayer inputting a Terminal Activation Code (TAC) obtained from MRA EIS Portal after applying for a terminal.
The API validates the code and returns configurations that must be set on the terminal. The configurations contain taxpayer information, terminal security keys and global configuration.
Once the terminal receives the configuration data from the API, it is expected to persist this information locally eg in an embedded database or any other means. When the process of persisting the configuration is successful, the terminal must confirm with the API so that the terminal should be flagged as activated. If the terminal activated confirmation is not sent, the terminal will remain inactivated and the API will not be able to processes any subsequent messages.
After the terminal is confirmed activated, it may display a feedback message to the taxpayer such as "Your terminal has successfully been activated".