# Api:Wallet

**Page:** api/api-wallet

[Download Raw Markdown](./api/api-wallet.md)

---

## API Endpoints Summary

- **GET** `/api/v1/wallet/balances` — Get aggregate balances (general + AI)
- **GET** `/api/v1/wallet/balances/general` — Get general balance only
- **GET** `/api/v1/wallet/balances/ai` — Get AI balance (limit, usage, remaining)
- **POST** `/api/v1/wallet/transfers` — Transfer from general balance to AI credits
- **GET** `/api/v1/wallet/transactions` — List transactions
- **GET** `/api/v1/wallet/transactions/{id}` — Get transaction by ID
- **GET** `/api/v1/wallet/ai-fee-history` — Get AI credit fee history
- **GET** `/api/v1/wallet/payment-methods/` — Get all payment methods
- **POST** `/api/v1/wallet/payment-methods/` — Add a new payment method
- **GET** `/api/v1/wallet/payment-methods/{id}` — Get payment method by ID
- **PUT** `/api/v1/wallet/payment-methods/{id}` — Update a payment method
- **PATCH** `/api/v1/wallet/payment-methods/{id}` — Update a payment method
- **DELETE** `/api/v1/wallet/payment-methods/{id}` — Delete a payment method
- **PUT** `/api/v1/wallet/payment-methods/{id}/default` — Set a payment method as default
- **PATCH** `/api/v1/wallet/payment-methods/{id}/default` — Set a payment method as default
- **POST** `/api/v1/wallet/payments/` — Process a payment
- **GET** `/api/v1/wallet/payments/{id}` — Get payment status
- **GET** `/api/v1/wallet/invoices/` — Get all invoices
- **GET** `/api/v1/wallet/invoices/{id}` — Get invoice by ID
- **GET** `/api/v1/wallet/invoices/{id}/pdf` — Download invoice PDF
- **POST** `/api/v1/wallet/invoices/generate/{id}` — Generate invoice for transaction

## CLI

```bash
# CLI mapping will be generated from the SDK CLI sources in a later step.
# Example (placeholder):
# hoody-cli <command> --help
```