Réservé ; utilisé par certaines API pour les problèmes de facturation.
Quand l’utiliser
Limite du forfait atteinte ou échec du paiement.
Causes courantes et solutions
402 a été réservé pour un usage futur sans jamais être standardisé : son sens dépend donc de l’API. Stripe renvoie 402 quand une carte est refusée ou qu’un paiement échoue, avec la raison dans le corps de l’erreur, et Shopify le renvoie quand une boutique est gelée pour factures impayées. D’autres API SaaS l’utilisent à la fin d’une période d’essai ou quand une limite du forfait est atteinte. Lisez le code d’erreur dans le corps, pas seulement le statut.
Ne réessayez pas automatiquement après un 402 : il ne disparaîtra pas tant que quelqu’un n’aura pas mis à jour la facturation ou changé de forfait, alors présentez-le à un humain avec un lien vers la page de facturation. Si vous concevez une API, 402 est un choix raisonnable pour les blocages liés à la facturation, distinct de 403 pour les permissions et de 429 pour les limites de débit, mais documentez-le, car les clients génériques le traitent simplement comme une erreur 4xx inconnue.
Erreur client (4xx)
Les codes 4xx sont des erreurs client : la requête elle-même est incorrecte, non autorisée ou vise quelque chose qui n’existe pas. Renvoyer la même requête ne servira à rien.
À quoi ça ressemble
HTTP/1.1 402 Payment RequiredComment l’envoyer
| Node.js / Express | res.status(402).end() |
|---|---|
| Python / Flask | return '', 402 |
| nginx | return 402; |
Comment le vérifier
curl -s -o /dev/null -w "%{http_code}\n" https://example.com/