Update Wallet Status API

Overview

Allows Super Admins to freeze or unfreeze a company wallet.

• Endpoint: /api/wallet/status
• Method: POST
• Auth Required: Yes (Bearer <token>)

Request Body Schema

Field	Type	Required	Description
companyId	String (UUID)	Yes	Target company ID
active	Boolean	Yes	Active status (true to unfreeze, false to freeze)
reason	String	No	Optional reason for freezing or status change

Request Body Example

{
  "companyId": "c478a846-993d-4c8d-bf8d-d77cb3370e01",
  "active": false,
  "reason": "Pending compliance verification"
}

Response Example (200 OK)

{
  "success": true,
  "data": {
    "companyId": "c478a846-993d-4c8d-bf8d-d77cb3370e01",
    "active": false
  },
  "message": "Wallet status updated successfully"
}