402 Payment Required ("необходима оплата")

https://httpcat.ru/402

Это прямая ссылка на изображение со статусом. Вы можете скопировать и использовать её где угодно.

Описание

Код состояния 402 Payment Required зарезервирован для использования в будущем, но может применяться в частных API как сигнал о необходимости оплаты перед получением доступа к ресурсу.

Основные характеристики:

Официально не используется в спецификациях HTTP, но предусмотрен для систем, где требуется платёж
В некоторых API сигнализирует, что у пользователя недостаточно баланса, неактивная подписка или просроченный платёж
В большинстве реализаций сопровождается сообщением об оплате или ссылкой на платёжную страницу

Типичное использование:

GET /api/premium-data HTTP/1.1
Authorization: Bearer abc123

HTTP/1.1 402 Payment Required
Content-Type: application/json

{
    "error": "Subscription required",
    "paymentUrl": "https://example.com/subscribe"
}

Особенности заголовков:

Content-Type — если сервер возвращает структуру с описанием причины отказа
Retry-After — может указывать, когда пользователь может повторить запрос (если применяется)

Когда использовать:

В API, где доступ к ресурсу возможен только после оплаты
При проверке подписки, баланса или ограничений тарифа
Когда важно явно разделить отказ из-за неоплаты от других ошибок авторизации

Дополнительно:

Статус 402 **не используется в публичных HTTP-спецификациях**, но допустим в кастомных системах
Может быть полезен как часть бизнес-логики: "Оплатите, чтобы продолжить"
Важно сопровождать 402 понятным сообщением и ссылкой на действия для разблокировки доступа

Документация: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/402