В документе описан пошаговый гайд по размещению интеграции с вашим сервисом в маркетплейсе Altegio. В контексте маркетплейса каждая интеграция называется «приложением».
ШАГ 1 — Создайте свое первое приложение
- Получите доступ к личному кабинету разработчика. Для этого перейдите по ссылке. Примечание: личный кабинет будет доступен только для того пользователя Altegio, из-под которого вы создали его.
- В ЛК разработчика создайте свое первое приложение для маркетплейса.
ШАГ 2 — Интегрируйтесь с API маркетплейса
- Реализуйте запрос на подключение вашего приложения в локацию пользователя.
- Реализуйте передачу данных об оплатах вашего сервиса.
- Реализуйте обработку вебхука об отключении интеграции на стороне Altegio.
ШАГ 2.5 — Протестируйте на своей локации до модерации
Перед отправкой приложения на модерацию установите черновик на локацию, которой вы управляете, и выполните реальные API-запросы. Это self-service — модерация не требуется.
- В ЛК разработчика откройте раздел «General info» вашего приложения и скопируйте «Link to request a review» (см. Генерация ссылки на приложение).
- Откройте эту ссылку под администратором вашей тестовой локации и нажмите «Подключить». Приложение свяжется с локацией в статусе pending.
- Со стороны вашего сервиса отправьте запрос на подключение в течение 1 часа, чтобы активировать связь — см. Подключение интеграции через маркетплейс.
- Убедитесь, что приложение в статусе active, и начинайте вызывать API локации с токеном системного пользователя.
Точные эндпоинты, токены, хосты и примеры для копирования — в руководстве для разработчиков Install & test your app before moderation.
ШАГ 3 — Пройдите модерацию приложения
Для публикации вашего приложения в маркетплейсе Altegio необходимо пройти процесс модерации. После создания в карточке приложения появится вкладка «Публикация» с чек-листом, который поможет подготовить приложение к модерации.
В рамках модерации сотрудники Altegio проверят, что ваше приложение:
- Корректно подключается к локации клиента.
- Передает данные об оплатах.
- Передает данные о возвратах оплат.
- Корректно обрабатывает кейс с отключением и повторным подключением интеграции.
- Корректно обрабатывает кейс с подключением интеграции, когда пользователь уже зарегистрирован в вашей системе.
Когда вы завершите разработку по интеграции с API маркетплейса и проверите работоспособность интеграции на своей стороне, заполните поля чек-листа. В чек-листе есть обязательные и необязательные поля для заполнения, кнопка «Отправить на модерацию» станет доступна после заполнения обязательных полей.
Подробная инструкция по прохождению модерации приложения здесь.
После завершения проверки на стороне Altegio и устранения всех обнаруженных ошибок, ваша интеграция станет доступной для пользователей в маркетплейсе в выбранной вами категории.
Партнёрства и интеграции
По всем вопросам, связанным с партнёрствами — включая международные направления, а также агрегаторы, телефонию и другие виды сотрудничества — обращайтесь на адрес: [email protected]