У цьому документі — покроковий гайд із розміщення інтеграції з вашим сервісом у маркетплейсі 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 завершить перевірку й усі виявлені помилки буде усунено, ваша інтеграція стане доступною користувачам у маркетплейсі у вибраній вами категорії.