Obtener wallet

Devuelve la wallet del usuario con su balance y sus sub-wallets (agentes). La primera vez que se consulta, la wallet se provisiona on-demand (idempotente).

GET /api/v1/wallet

Auth: sesión. Montos: el balance viene en unidades (pesos, 2 decimales); los caps de approval_config en centavos.

Respuesta `200`

{
  "id": "wal_9f2c1a7b3e4d4f80a1b2c3d4e5f60718",
  "cvu": "0000076500000012345678",
  "alias": "joe.argentive",
  "currency": "ARS",
  "balance": {
    "available": 15000.50,
    "pending": 2500.00,
    "total": 17500.50
  },
  "sub_wallets": [
    {
      "id": "sub_1b2c3d4e5f60718293a4b5c6d7e8f900",
      "agent": "compras",
      "purpose": "Insumos de oficina",
      "payees": ["proveedor.principal"],
      "payeeItems": [
        { "alias": "proveedor.principal", "enabled": true },
        { "alias": "gastos.varios", "enabled": false }
      ],
      "cvu": "0000076500000012345678",
      "balance": 7500.25,
      "currency": "ARS",
      "status": "active",
      "approval_config": {
        "auto_approve_under_cents": 100000,
        "whatsapp_threshold_cents": 500000,
        "panic_limit_24h_cents": 5000000,
        "per_day_cents": null,
        "per_month_cents": null,
        "notify_whatsapp": false
      },
      "created_at": "2026-08-15T10:30:00.000Z"
    }
  ],
  "provider": "cvu-rail",
  "approval_config": {
    "auto_approve_under_cents": 100000,
    "whatsapp_threshold_cents": 500000,
    "panic_limit_24h_cents": 5000000
  },
  "created_at": "2026-08-01T14:22:30.000Z",
  "updated_at": "2026-08-20T09:15:45.000Z"
}

Errores

Status	Body	Cuándo
`401`	`{ "error": "unauthorized" }`	Sin sesión.
`403`	`{ "error": "no_cardholder" }`	El usuario no tiene identidad dada de alta.
`403`	`{ "error": "kyc_required", "kycStatus": "pending" }`	Identidad sin KYC aprobado.
`500`	`{ "error": "wallet_provisioning_failed" }`	Falló el alta del CVU.

En MCP: wallet_balance.

Respuesta 200

Errores

On this page

Respuesta `200`