Handle Top-Up Action API

Overview

Allows Super Admin to approve or reject a pending wallet top-up request.

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

Request Body Schema

Field	Type	Required	Description
requestId	String (UUID)	Yes	Top-Up Request ID
action	Enum	Yes	APPROVE or REJECT
rejectionReason	String	No	Reason required if action is REJECT
referenceNo	String	No	Bank/Payment reference number

Request Body Example

{
  "requestId": "top_77665544",
  "action": "APPROVE",
  "referenceNo": "REF-BANK-12345"
}

Response Example (200 OK)

{
  "success": true,
  "data": {
    "requestId": "top_77665544",
    "status": "APPROVED",
    "walletBalanceAfter": 829840.00
  },
  "message": "Top-up request approved and wallet credited successfully"
}