| Method & path | Function | Billing |
|---|---|---|
| POST /api/v1/recommend/personalized | AI personalized recommendation (Jebi Brain) | Charged JBP by role |
| POST /api/v1/billing/quote | Price quote (no charge) | — |
| GET /api/v1/users/{id}/balance | Balance query | — |
| POST /api/v1/users/{id}/topup | JBP top-up (caps) | — |
| POST /api/v1/users/{id}/subscribe | Activate subscription (demo helper) | — |
| POST /api/v1/users/{id}/refund | 7-day cooling-off refund | — |
| GET /api/v1/admin/usage/summary | Usage audit (cost vs charged) | — |