# Пример использования сервиса интеграции
Рассмотрим пример использования API сервиса интеграции (opens new window). Для простоты предполагается, что на площадке продавцами могут быть только физические лица.
В случае продавцов - юридических лиц (ИП) техническое взаимодействие будет такое же, усложняется процедура подключения продавца к сервису и настройки со стороны продавца.
# Настройки со стороны продавца
Добавьте в интерфейс настроек продавца или в другое удобное место возможность активировать и настроить продажи через безопасную сделку. Мы рекомендуем добавить флажок «Подключить безопасную сделку и доставку». При активации флажка необходимо показывать кнопку «Настройки», по клике на которую пользователю должен открываться интерфейс по адресу https://{id площадки}.marketplace.nalozhka.ru/manage/settings/{seller_id}, где
{id площадки}: имя вашей площадки в системе (выдается сервисом Наложка),{seller_id}: уникальный идентификатор продавца на вашей площадке, к которому будут привязаны настройки.
Опционально можно указать в параметрах back_url, тогда после сохранения настроек, продавец будет перенаправлен на указанный в этом параметре адрес.
# Снимок 1. Пример интерфейса настроек продавца
Интерфейс настроек, как и другие интерфейсы, можно показывать пользователю или в iframe'ах или путем открытия страницы в новой вкладке. В настройках продавец указывает карту для выплаты, ФИО, телефон и город из которого будет отправлять заказы. Карту для выплаты продавец также сможет добавить в интерфейсе подтверждения, поэтому в настройках ее указывать не обязательно. Остальные данные нужны обязательно для автоматического создания накладных на доставку. Процесс указания настроек можно считать своеобразной «активацией» продавцов.
# Оформление безопасной сделки покупателем
Добавьте на страницу оформления заказа кнопку «Безопасная сделка».
# Снимок 2. Пример размещения кнопки
При клике на кнопку необходимо передать Наложке данные о заказе. Для этого отправьте запрос POST /api/order. В теле запроса нужно отправить данные заказа (структуру можно посмотреть в документации). В случае успеха, на нашей стороне создается заказ и ему устанавливается статус payment-waiting (ожидает оплаты).
Далее необходимо открыть покупателю страницу оформления и оплаты безопасной сделки. Она находится по адресу https://{id площадки}.marketplace.nalozhka.ru/order/{order_id}?back_url={back_url}. Как уже упоминалось - открыть можно в iframe или в новой вкладке.
# Снимок 3. Пример интерфейса оформления безопасной сделки
В интерфейсе покупатель должен выбрать пункт выдачи, в котором он хотел бы забрать заказ, ознакомиться с предварительной стоимостью доставки (предварительной – если при создании заказа площадка не передала габариты посылки, если габариты известны, то покупателю будет показана точная стоимость доставки). После оплаты, пользователь будет перенаправлен на страницу указанную в back_url.
Также Наложка отправляет в сторону площадки вебхук-уведомление, в котором присылает внесенные в заказ изменения. В данном случае будет изменен статус заказа с payment-waiting на confirmation-waiting. На основании этого уведомления площадка сможет поменять статус заказа или оплаты на своей стороне.
# Управление заказом со стороны продавца
После оплаты заказа покупателем наступает очередь продавца отправлять товар. Но прежде чем создать накладную, нам нужно узнать на какую карту продавец хочет получить выплату по заказу, какие габариты будут у посылки (если они не были указаны при создании заказа), а также получить от продавца явное подтверждение того, что он намерен заказ исполнить.
Все эти действия продавец может выполнить в интерфейсе «Управление заказом». Кнопку для перехода к этому интерфейсу удобно разместить на странице, на которой продавец просматривает список своих заказов.
# Снимок 4. Пример интерфейса управления заказом
Адрес интерфейса – https://{id площадки}.marketplace.nalozhka.ru/manage/{order_id}
После подтверждения заказа автоматически создается накладная на доставку. Продавцу выводится в интерфейсе номер накладной. С этим номером и товаром продавец идет в удобный для него пункт службы доставки, называет номер, отдает товар, дожидается окончания доставки и получает на карту деньги за заказ.
# Просмотра информации о заказе
У покупателя может возникать желание просматривать статус по заказу и доставке. Чтобы предоставить такую возможность, откройте пользователю интерфейс https://{id площадки}.marketplace.nalozhka.ru/order/{order_id}/info
