Lists wallet credit/debit history for the authenticated customer.
Query filters: page, limit, sortBy, sortOrder, all, currency, status, type, description, reference, transactionId, paymentGateway, paymentIntentId, paymentId, date range.
Response fields: data[], pagination. Wallet history fields: type, amount, exchangeRate, status (-1 failed, 0 pending, 1 success), description, source, reference, transactionId, paymentGateway, paymentIntentId, paymentId, balanceBefore, balanceAfter, currency, timestamps.
Possible errors:
- 400: Missing One or More Required Parameters - required body/query fields were not supplied.
- 401: Unauthorized - token is missing, expired, invalid, or the account/token pair was not found.
- 403: Access denied - gateway traffic guard/rate policy blocked the request.
- 429: Too many requests - gateway rate limit exceeded.
- 500: Unexpected Error - unhandled gateway or downstream service failure.