---

POST /api/utility/get-terminal-blocking-message

Purpose: Check if the terminal is currently blocked and retrieve the blocking reason/message.

Request Body

{
  "terminalId": "TID123456"
}

Response

{
  "statusCode": 1,
  "remark": "string",
  "data": {
    "isBlocked": true,
    "blockingReason": "Non-compliance with filing requirements",
    "blockedAt": "2026-01-14T07:42:26.748Z"
  },
  "errors": null
}

Typical Use

• Call at application startup or before allowing sales.
• If data.isBlocked == true, prevent further transactions, display blockingReason, and optionally log blockedAt.

---

Check Terminal Unblock Status

POST /api/utility/check-terminal-unblock-status

Purpose: After a terminal has been blocked and the taxpayer resolves the issue, use this to confirm that MRA has unblocked it.

Request Body

{
  "terminalId": "TID123456"
}

Response

{
  "statusCode": 1,
  "remark": "string",
  "data": {
    "isUnblocked": true
  },
  "errors": null
}

Typical Use

• Periodically poll (e.g., on login or every X minutes) while the terminal is blocked.
• When data.isUnblocked == true, allow operations again and optionally stop calling the blocking-message endpoint.