Вариант A — приложение из Центра приложений
Когда AgentPay появится в App Center (после модерации InSales):
- Бэкофис InSales → Приложения (Центр приложений).
- Найдите «AgentPay» → Установить.
- Разрешите доступ: товары (чтение) и заказы (чтение и запись). Лишние права приложение не запрашивает.
- После установки откройте приложение — браузер попадёт в кабинет продавца /business (вход из бэкофиса, отдельный пароль AgentPay не нужен).
- Проверьте таблицу товаров. Если пусто — кнопка Синхронизировать.
Заказ от агента приходит как обычный заказ InSales. В комментарии будет строка вида AgentPay purchaseId=3f2a… — не удаляйте её, по ней сверяются статусы.
Вариант B — пилот по ключу API (пока нет в App Center)
- InSales → Расширения → Разработчикам → Ключи доступа. Создайте ключ с правами на товары и заказы. Сохраните: домен магазина (например
myshop.myinsales.ru), API-ключ и пароль. - В AgentPay откройте /business → «Создать магазин»:
- Название — как в вывеске, например «Ферма №12».
- Коннектор — InSales.
- Сохраните
mk_…и UUID. Дальше в карточке магазина (или через поддержку пилота) укажите домен и ключи InSales — либо напишите help@agentpay.shop: «пилот InSales, домен …, готов дать ключ в тикете». - Нажмите Синхронизировать. В таблице должны появиться SKU и цены как в InSales.
Проверка «заказ дошёл»
- В кабинете покупателя магазин должен быть в списке разрешённых для агента (это делает покупатель, не вы).
- Тестовый заказ: позиция с вашим SKU, сумма в коинах.
- InSales → Заказы: новый заказ, клиент «AgentPay» или данные доставки покупателя, комментарий с purchaseId.
- Смените статус выполнения в InSales — в кабинете продавца AgentPay статус заказа должен стать confirmed / fulfilled / cancelled.
Что нужно с вашей стороны
| Поле в InSales | Зачем агенту |
|---|---|
| Артикул варианта (SKU) | Сборка заказа. Без SKU риск дубля и ошибки позиции. |
| Цена, остаток, фото | Агент не предложит «пустую» карточку. |
| Стабильный id варианта | Повторный заказ не создаёт второй документ. |
Служебные URL (для IT / модерации InSales)
База API — хост AgentPay (локально http://localhost:3100, прод — HTTPS).
- Установка приложения:
GET/POST {API}/integrations/insales/install - Вход из бэкофиса:
GET {API}/integrations/insales/login - Удаление:
GET/POST {API}/integrations/insales/uninstall - Вебхуки:
POST {API}/integrations/insales/webhooks
В карточке публичного приложения InSales эти три URL (install / login / uninstall) указываются полностью, только HTTPS, без самоподписанного сертификата.
Поддержка: help@agentpay.shop. Оферта спецмагазина — в документах AgentPay. Другие платформы.