Все ошибки следуют RFC 7807. Тело ответа — application/problem+json с полями type, title, status, detail, request_id и опционально reason или errors[].
{
"type": "https://www.kernelhost.com/en/kernelhost-api/errors/payment_required",
"title": "Payment required",
"status": 402,
"detail": "The order could not be paid.",
"request_id": "01HX7Z3K8Q...",
"reason": "insufficient_credit_and_no_card"
}| HTTP | type | Значение |
|---|---|---|
| 400 | validation_failed | Валидация входных данных не прошла. См. errors[] для деталей по каждому полю. |
| 401 | auth_failed | Ошибка аутентификации. Ответ всегда содержит reason unauthorized (или ip_not_allowed, если ключ ограничен другими IP-адресами) и намеренно не раскрывает ничего больше. Проверьте ключ, secret, время (±300 с), nonce и подпись; служба поддержки установит точную причину по request_id. |
| 402 | payment_required | Требуется оплата. reason — см. ниже. |
| 403 | forbidden_scope | Нет разрешения. reason: missing_scope. |
| 404 | not_found | Ресурс не существует или не виден для этого ключа (защита от перечисления арендаторов). |
| 409 | idempotency_conflict, order_in_progress, service_not_active | Конфликт. Либо Idempotency-Key уже использовался с другим телом запроса или на другом endpoint (idempotency_conflict, reason in_progress, пока первый запрос ещё выполняется), либо ещё обрабатывается другой заказ вашего аккаунта (reason order_in_progress, соблюдайте Retry-After), либо услуга находится в состоянии, которое не допускает это действие (service_not_active, см. service_status). |
| 413 | payload_too_large | Body запроса превышает 65 536 байт. Такой запрос отклоняется ещё до аутентификации. |
| 422 | unprocessable | Запрос понятен, но не может быть выполнен. reason billing_cycle_not_available: продукт не предлагается с этим расчётным периодом. reason zero_total_not_allowed: заказ стал бы бесплатным без веской причины, например промокода. |
| 429 | rate_limited | Превышено ограничение частоты. Соблюдайте заголовок Retry-After. |
| 500 | internal_error | Внутренняя ошибка сервера. При обращении в поддержку указывайте request_id для сопоставления с журналом аудита. |
Причины Payment Required (HTTP 402)
Если заказ невозможно оплатить, API возвращает HTTP 402 с машинно-читаемым reason в JSON теле.
insufficient_credit_and_no_card(Баланса недостаточно и карта не привязана. Решение: пополните баланс или добавьте карту в клиентском портале.)card_declined(Карта отклонена банком или платёжным шлюзом. Решение: попробуйте другую карту или свяжитесь с банком.)credit_apply_failed(Не удалось применить баланс к счёту. Средства не списаны, заказ отменён. Повторите попытку с новым Idempotency-Key или обратитесь в службу поддержки.)client_not_found(Идентификатор аккаунта не найден (практически не должно происходить, обратитесь в поддержку).)
