402 - Quota or budget exceeded

A 402 has two flavors. Read the error.code field to know which one.

Case 1 - Monthly quota exceeded

{
  "error": {
    "code":              "quota_exceeded",
    "message":           "Monthly request quota reached (100,000 / 100,000).",
    "included_requests": 100000,
    "used_requests":     100000,
    "upgrade_url":       "https://www.hiway2llm.com/upgrade"
  }
}

Your HiWay wallet balance is insufficient to cover the markup for this period. Top up your wallet in Dashboard → Billing, or enable auto-reload to top up automatically. Routing falls back to passthrough mode (service continues, savings suspended) while the wallet is empty.

Case 2 - Budget Control BLOCK verdict

{
  "error": {
    "code":       "budget_exceeded",
    "message":    "Monthly BYOK budget cap reached ($500.00 / $500.00).",
    "verdict":    "BLOCK",
    "cap_usd":    500.0,
    "spent_usd":  500.02,
    "reset_at":   "2026-05-01T00:00:00Z"
  }
}

Your upstream BYOK spend hit the cap you set in Dashboard → Budget Control. Raise the cap, or wait for the month reset.

Case 3 - Passthrough grace cap exceeded

{
  "error": {
    "type":              "payment_required",
    "code":              "grace_period_exceeded_time",
    "message":           "Grace period exceeded. Please top up your wallet to resume service.",
    "passthrough_since": "2026-05-26T08:00:00Z",
    "elapsed_hours":     74.2,
    "tokens_consumed":   65000,
    "topup_url":         "https://app.hiway2llm.com/wallet"
  }
}

Your wallet has been at 0 long enough to exceed the passthrough grace cap (72 hours OR 100,000 tokens, whichever comes first). The code field tells you which dimension tripped: grace_period_exceeded_time, grace_period_exceeded_tokens, or grace_period_hard_cut (already past the cap). Top up your wallet, passthrough mode is reset automatically and service resumes.