Чек-лист запуска и справка

Чек-лист перед запуском

[ ] Ключ хранится в защищённом конфиге, а не в коде и не в клиенте

• [ ] Ключ не попадает в логи, в том числе в логи HTTP-запросов
• [ ] Ключ привязан к точке: в сети касс каждая точка использует свой
• [ ] idempotencyKey генерируется один раз на чек и сохраняется до получения ответа
• [ ] 409 с existingSaleId обрабатывается как успех
• [ ] 401 не приводит к бесконечным ретраям
• [ ] Кассир не может ввести к списанию больше maxRedeemPoints
• [ ] Недоступность uget не блокирует продажу
• [ ] Числа предпросмотра не сверяются программно с итогом продажи
• [ ] Проверено в песочнице sandbox.uget.uz до переключения на connect.uget.uz

Справочные материалы

Эта документация в виде сайта — https://sandbox.uget.uz/ (собирается из этого файла, см. integrations-site/, выкладка — tools/deploy-integrations-site.sh).

• Интерактивная спецификация (Swagger UI) — в песочнице: https://sandbox.uget.uz/swagger-ui.html, раздел Integration · POS. В боевом профиле Swagger отключён.
• Машиночитаемая схема для генерации клиента: https://sandbox.uget.uz/v3/api-docs.
• Управление ключами со стороны кабинета — /api/merchant/settings/pos-api-keys (это API кабинета мерчанта, вашей кассе он недоступен).

Вопросы по интеграции и заявка на боевой доступ — через мерчанта, у которого вы устанавливаете кассу.