Skip to main content

wallet-api

Wallet API

  • Base Path: /api/v1/wallet
  • Auth: required

Get My Wallet

  • Method: GET
  • Path: /api/v1/wallet/me
  • Auth: required (no guests)
  • Request Body: none
  • Response 200:
{
  "availableZishPoints": 120,
  "withdrawalBalance": 120
}
  • Errors:
    • 401: { "error": "UNAUTHORIZED", "message": "Login required" }
    • 500: { "error": "Failed to fetch wallet" }

Notes

  • totalPoints: Current point balance for the authenticated user.
  • withdrawalBalance: Amount available to withdraw. Currently equals totalPoints. Business rules can adjust this in the future (e.g., holds or pending amounts).