inCust Knowledge Base
Архів бази знаньПрограми, інтеграція і API

Довідник з API та інтеграції

🌐 Public

Архівна копія зі старої бази знань inCust (deprecated). Оригінал: https://incust.com/ua/knowledgebase/documentation/api-reference-integration/

Довідник з API та інтеграції

Документ описує підходи до інтеграції платформи inCust із сторонніми системами — обліковими/POS-системами та інтернет-магазинами — а також перелічує доступні технічні ресурси для розробників.

Інтеграція з обліковою системою та POS

Інтеграція передбачає кілька способів ідентифікації клієнта на стороні продавця:

  • ручне введення номера телефону покупця;
  • сканування QR-коду картки з мобільного додатку inCust;
  • сканування або введення номера пластикової картки;
  • автоматичне визначення присутності клієнта через додаток «Кіоск» на планшеті.

Для розробників доступний документ «Опис команд терміналу (API Терміналу)» — він містить специфікацію команд, що використовуються POS-плагінами та обліковими системами для взаємодії з платформою inCust.

Інтеграція з інтернет-магазином

Для онлайн-комерції описані два ключові етапи бонусних операцій.

Нарахування бонусів

Бонуси рекомендується нараховувати в момент отримання платежу або відвантаження товару. Виклик відповідного API-ендпоінту виконується з облікової системи магазину або з внутрішнього модуля інтеграції.

Списання бонусів

Існують два сценарії використання бонусів покупцем:

  • повне покриття вартості замовлення накопиченими бонусами;
  • застосування бонусів як знижки на частину суми.

Важлива вимога: списання бонусів допускається тільки після того, як покупця ідентифіковано. Обов'язковою є перевірка ПІН-коду — без неї операція не повинна виконуватись, оскільки інакше виникає ризик неправомірного використання балансу.

Контактна інформація (на момент архівації)

On this page