Request Wallet Top-Up API

Overview

Allows Company Admin or Manager to request a wallet top-up credit increase from Super Admin.

• Endpoint: /api/wallet/request-topup
• Method: POST

Request Body Schema

Field	Type	Required	Description
companyId	String (UUID)	Yes	Target company ID
amount	Number	Yes	Requested credit amount
reason	String	No	Reason for top-up request

Request Body Example

{
  "companyId": "comp_12345678",
  "amount": 250000.00,
  "reason": "Q4 Corporate Event & Client Travel Expenses"
}

Response Example (201 Created)

{
  "success": true,
  "data": {
    "requestId": "top_77665544",
    "status": "REQUESTED",
    "amount": 250000.00,
    "createdAt": "2026-09-01T15:00:00.000Z"
  },
  "message": "Top-up request submitted successfully"
}