Get User Wallet

GET

http://localhost:9000/api/v1/billing/wallet

Returns the authenticated customer’s wallet.

Response wallet fields: _id, user, currency, mainBalance object with NGN, USD, GBP, isActive, paymentHistory[], createdAt, updatedAt.

Possible errors:

404: Wallet not found - customer wallet has not been created.
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.

Returns the authenticated customer's wallet. Response wallet fields: `_id`, `user`, `currency`, `mainBalance` object with `NGN`, `USD`, `GBP`, `isActive`, `paymentHistory[]`, `createdAt`, `updatedAt`. Possible errors: - 404: Wallet not found - customer wallet has not been created. - 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.

Response

key_0integer

key_1string

key_2double

key_3string

key_4boolean

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

1	{
2	"key_0": 987654321,
3	"key_1": "user_5f8d0d55b54764421b7156c3",
4	"key_2": 1520.75,
5	"key_3": "USD",
6	"key_4": true
7	}