Коды ошибок

Ошибка приходит в свойстве error объекта ответа — см. структуру ответа. Перечень пополняется: незнакомый code обрабатывайте по HTTP-коду, а не игнорируйте.

Авторизация и доступ

Код ошибки	HTTP	Что произошло	Что делать
`unauthorized`	401	Токен не передан или не распознан	Проверить заголовок `Authorization: Bearer <токен>` — авторизация
`forbidden`	403	Доступ к ресурсу или объекту запрещён	Проверить, принадлежит ли объект вашему магазину и есть ли у токена нужные права

Проверка заказа (422)

Все эти ошибки означают, что запрос дошёл и разобран, но данные не сходятся. Правило подсчёта сумм — в разделе как считаются суммы.

Код ошибки	Что произошло	Что делать
`wrong_expiration_date`	Неверный срок действия заказа	Проверить `expirationDate`: время в будущем, формат с часовым поясом
`wrong_currency`	Неверная валюта	Проверить `currencyId`
`language_not_found`	Неверный язык заказа	Проверить `languageId`: `ru` или `en`
`wrong_basket_item_total_amount`	Итог позиции не сходится	`totalAmount` позиции = `quantity × amount`
`wrong_basket_item_total_vat_amount`	НДС позиции не сходится	Пересчитать `totalVatAmount` по ставке из `vatCode`
`wrong_basket_item_amount_wo_vat`	Стоимость позиции без НДС не сходится	Проверить `amountWoVat` для одной единицы
`wrong_total_amount`	Сумма заказа не равна сумме позиций	`amount` заказа = сумма `totalAmount` позиций
`wrong_total_vat_amount`	Сумма НДС заказа не равна сумме НДС позиций	`vatAmount` заказа = сумма `totalVatAmount` позиций
`wrong_order_status`	Операция недопустима в текущем статусе	Посмотреть статус заказа и разрешённые переходы — работа с заказом
`merchant_order_id_duplicate`	Такой `merchantOrderId` уже использовался. Приходит, только если у магазина включена проверка уникальности (настройка меняется через поддержку)	Заказ с этим номером уже создан — найдите его выборкой и работайте с ним. Новый номер генерировать не нужно: так появится второй заказ на ту же покупку. См. повтор после сбоя

Технические

HTTP	Что произошло	Что делать
429	Слишком много запросов	Снизить частоту и повторить с задержкой — ограничения. Тело может не содержать `code`
500	Необработанная ошибка на стороне сервиса	Результат операции неизвестен: запрос мог дойти. Чтение можно повторить сразу; после создания заказа, возврата или отмены сначала проверьте выборкой, прошла ли операция, — повтор после сбоя. Сообщите нам `x-request-id` из заголовков ответа. Тело может не содержать `code`