Wallets

Every account starts with a primary wallet; add labeled wallets when you need them.

Every new user gets a primary wallet with balance 0. You can add more wallets with your own labels. Payments settlement comes later — providerRef stays null for now.

GET BASE/v1/api/user/wallets
Cookie: <session>

POST BASE/v1/api/user/wallets
Cookie: <session>
Content-Type: application/json

{ "label": "savings", "currency": "NGN" }

GET BASE/v1/api/user/wallets/{id}
Cookie: <session>

Example wallet row:

{
  "id": "…",
  "label": "primary",
  "currency": "NGN",
  "balance": "0.00",
  "providerRef": null,
  "createdAt": "2026-07-24T05:00:00.000Z",
  "updatedAt": "2026-07-24T05:00:00.000Z"
}