Cancel Wallet Top-Up Request API

Overview

Allows Company Admin to cancel a previously submitted top-up request while it is still in REQUESTED state.

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

Request Body Schema

Field	Type	Required	Description
requestId	String (UUID)	Yes	Target request ID

Request Body Example

{
  "requestId": "top_77665544"
}

Response Example (200 OK)

{
  "success": true,
  "data": {
    "id": "top_77665544",
    "status": "CANCELLED",
    "amount": 250000.00,
    "rejectionReason": "Cancelled by Company Admin",
    "updatedAt": "2026-09-04T12:00:00.000Z"
  },
  "message": "Wallet top-up request cancelled successfully"
}