Разработчику

Этот раздел — для разработчиков и интеграторов на стороне магазина. Здесь описаны инструменты, которыми можно расширять поведение мобильного приложения и автоматизировать работу с каталогом и заказами, не выходя за пределы публичных контрактов.

Если вы владелец магазина и настраиваете приложение через админ-панель — вам в документацию для мерчанта.

Разделы

• Merchant API — REST API для внешних учётных систем: импорт цен и остатков, управление заказами.
• Вебхуки — получать события приложения (заказы, бонусы, расчёты) на свой URL.
• Интерактивные HTML-блоки — управлять приложением из HTML-вставок: переходы, корзина, шторки, документы.
• Диплинки — ссылки с сайта, из письма или QR-кода, открывающие приложение на нужном экране.
• Действия при нажатии на push — переход на нужный экран из push-уведомления.

Работа с каталогом и заказами

Для загрузки цен и остатков, чтения и обновления заказов из внешней учётной системы используется REST Merchant API: авторизация по bearer-токену, асинхронный импорт цен и остатков, синхронное управление заказами и статусами. Полный контракт со схемами полей — в OpenAPI-спецификации merchant-api-docs.yml.

С чего начать

• Нужно синхронизировать цены, остатки и заказы с внешней системой — начните с Merchant API.
• Нужно реагировать на события магазина (создан заказ, оплачен, начислены бонусы) — смотрите вебхуки.
• Нужно встроить кнопки и переходы прямо в контент приложения — смотрите интерактивные блоки.
• Нужно привести человека в приложение снаружи — с сайта, из письма или QR-кода — смотрите диплинки.
• Нужно, чтобы push открывал конкретный экран — смотрите действия при нажатии на push.