Ошибки API

API может возвращать следующие ошибки в ответе. Поле message варьируется в зависимости от контекста. Некоторые ошибки могут включать уникальный error_id для помощи в отладке внутренних проблем.

Коды ошибок

Код ошибки	Описание
`BAD_REQUEST`	Запрос был недействительным или неправильно сформирован.
`INTERNAL_ERROR`	Произошла неожиданная ошибка сервера.
`NOT_FOUND`	Запрошенный ресурс (например, инвойс) не найден.
`VALIDATION_ERROR`	Не удалось пройти валидацию входных данных (отсутствующие или недействительные поля).
`MERCHANT_BLOCKED`	Мерчант заблокирован и не может выполнить это действие.
`PLAN_UPGRADE_REQUIRED`	Мерчанту необходимо повысить свой план для выполнения этого действия.
`MAINTENANCE`	API временно недоступен из-за технического обслуживания.
`RATE_LIMIT_EXCEEDED`	Запрос был отклонён, потому что клиент превысил допустимое количество запросов за определённый период времени.

Примеры ответов с ошибками

{
"error": {
  "code": "NOT_FOUND",
  "message": "Мерчант не найден",
  }
}

{
"error": {
  "code": "RATE_LIMIT_EXCEEDED",
  "message": "Превышен лимит запросов",
  }
}

{
"error": {
  "code": "INTERNAL_ERROR",
  "message": "Внутренняя ошибка сервера",
  "error_id": "2de6e835-8a50-4e50-98ae-ce53cf66c042"
  }
}

{
"error": {
  "code": "NOT_FOUND",
  "message": "Обновите свой план до business для доступа к этому эндпоинту",
  }
}

{
"error": {
  "code": "MAINTENANCE",
  "message": "В настоящее время мы проводим техническое обслуживание. Пожалуйста, попробуйте позже",
  }
}