Mode passthrough & cap de grâce

Wallet à 0 ? Le service continue en BYOK direct pendant 72h / 100k tokens, puis arrêt soft jusqu'au rechargement.

Quand votre wallet HiWay atteint zéro, on ne coupe pas votre trafic. Le routing bascule automatiquement en mode passthrough : les requêtes partent directement vers votre provider BYOK (sans markup, sans smart routing, sans semantic cache). Vous continuez à shipper, votre wallet reste juste à zéro jusqu'au prochain rechargement.

Pourquoi on a fait ça

Les top-ups Stripe prennent quelques minutes à se settler. Une panne agrégateur ou une carte expirée ne devrait pas couper votre trafic prod en plein milieu de journée. Le passthrough est une couche de dégradation gracieuse, il s'active automatiquement et se désactive automatiquement au rechargement.

Ce qui change en passthrough

Les requêtes sont facturées par votre provider BYOK directement (comme toujours).
Markup HiWay = 0% pendant le passthrough.
Le smart routing est suspendu, votre requête utilise le modèle exact que vous demandez, sans auto-downgrade.
Le semantic cache est suspendu (écritures pausées, lectures encore servies).
L'observabilité, les audit logs et le Security Shield continuent de tourner.

Le cap de grâce (72h ou 100k tokens)

Le passthrough n'est pas illimité. Chaque cycle passthrough est capé à 72 heures OU 100 000 tokens consommés, le premier atteint. Au-delà, HiWay renvoie HTTP 402 sur les nouvelles requêtes jusqu'à votre rechargement. Le cap se réinitialise dès que votre wallet est crédité à nouveau.

Trigger	Email envoyé	Comportement
Wallet atteint 0	Passthrough activé	Service continue, markup = 0%
50% du cap (36h OU 50k tokens)	Email d'avertissement	Identique, juste un heads-up
100% du cap (72h OU 100k)	Email de hard cut	Les nouvelles requêtes renvoient HTTP 402
Wallet rechargé	Passthrough désactivé	Retour mode normal, cap effacé

Quand vous atteignez le cap

Le corps d'erreur distingue les trois raisons de refus pour que votre client réagisse correctement :

json

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

code vaut grace_period_exceeded_time, grace_period_exceeded_tokens, ou grace_period_hard_cut (déjà passé le cap sur une requête précédente).

Override admin disponible

Les clients Enterprise peuvent demander au support une extension temporaire du cap, utile pour des délais de paiement connus ou des batchs de fin de mois. Les overrides sont audit-loggés et limités dans le temps.

Comment monitorer

Dashboard → Wallet affiche votre état courant. Si vous êtes en passthrough, il montre la part du cap consommée (heures + tokens) et l'heure projetée du hard-cut. Vous pouvez câbler votre propre webhook sur l'événement account.low_balance pour être notifié hors du dashboard.