402 - Quota ou budget dépassé

Un 402 a deux saveurs. Lisez le champ error.code pour savoir laquelle.

Cas 1 - Quota mensuel dépassé

{
  "error": {
    "code":              "quota_exceeded",
    "message":           "Quota mensuel atteint (100 000 / 100 000).",
    "included_requests": 100000,
    "used_requests":     100000,
    "upgrade_url":       "https://www.hiway2llm.com/upgrade"
  }
}

Votre wallet HiWay est vide (solde insuffisant pour payer le markup du mois). Rechargez-le dans Tableau de bord → Facturation, ou activez l'auto-reload pour que ça se fasse automatiquement. Le routage passe en passthrough (service continu, économies suspendues) tant que le wallet est vide.

Cas 2 - Verdict BLOCK de Budget Control

{
  "error": {
    "code":       "budget_exceeded",
    "message":    "Plafond BYOK mensuel atteint ($500,00 / $500,00).",
    "verdict":    "BLOCK",
    "cap_usd":    500.0,
    "spent_usd":  500.02,
    "reset_at":   "2026-05-01T00:00:00Z"
  }
}

Votre dépense BYOK upstream a touché le plafond que vous avez fixé dans Tableau de bord → Budget Control. Augmentez le plafond, ou attendez le reset mensuel.

Cas 3 - Cap de grâce passthrough dépassé

{
  "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"
  }
}

Votre wallet est à 0 depuis assez longtemps pour dépasser le cap de grâce passthrough (72 heures OU 100 000 tokens, le premier atteint). Le champ code vous dit quelle dimension a tripé : grace_period_exceeded_time, grace_period_exceeded_tokens, ou grace_period_hard_cut (déjà passé le cap). Rechargez votre wallet, le passthrough est réinitialisé automatiquement et le service reprend.