Validate Authorization Code

---

POST /api/utility/validate-authorization-code

Purpose: Confirm that an MRA-issued authorization code (e.g., for special transactions or relief) is valid, not expired, and not already used.

Request Body

{
  "authorizationCode": "AUTH-ABC-123"
}

Response

{
  "statusCode": 1,
  "remark": "string",
  "data": {
    "isValidAuthorizationCode": true,
    "authorizationCode": "AUTH-ABC-123",
    "authorizationReason": "VAT relief for project PRJ-123",
    "generatedBy": "MRA User",
    "generatedOn": "2026-01-14T07:44:02.162Z",
    "expiresOn": "2026-01-31T23:59:59Z",
    "usedOn": null
  },
  "errors": null
}

Typical Use

• When the cashier/operator enters an authorization code for a transaction, call this first.
• Only proceed if statusCode == 1 and data.isValidAuthorizationCode == true.
• You can also display authorizationReason to the operator and enforce expiresOn client-side if you want extra safety.