Списання бонусів з підтвердженням по SMS/Дзвінку

Для чого використовується

Коли в програмі активована бонусна система, то, щоб зменшити можливість махінацій з боку персоналу, можна активувати списання бонусів з підтвердженням по коду з SMS або по дзвінку.

Як це працює

Під час покупки, якщо продавець вибрав клієнта, відображається допустима сума бонусів, яку можна використати як знижку на весь чек. Кількість бонусів до списання можна ввести будь-яку, щоб було зручніше давати решту.

Якщо продавець ввів суму бонусів для списання - то покупцю на телефон приходить SMS з кодом, який він має продиктувати продавцю. Якщо продавець вводить правильний код - бонуси списуються.

Щоб налаштувати списання бонусів з підтвердженням по СМС, потрібно зайти в меню : “Сервіс”-“Торгове обладнання та Екран касиру”, закладка “Бонуси списання”, і ввести URL адресу сайта/сервісу, який буде відповідальний за надсилання СМС. Надсилати можна класичними СМС, а також можна надсилати в месенджери, або використовувати інші канали зв'язку.

Звернуть увагу, що наша компанія не надає послуги з надсилання СМС, цим займаються різні СМС-провайдери, і ці послуги платні. Так само надсилати в месенджери просто так не можна, один з дозволених способів - це щоб клієнт підключив собі в месенджері “Бота”, і цей Бот зможе надсилати йому СМС. Ми даємо тільки програмний інтерфейс (API) для зв'язку програми Unipro із зовнішньою системою розсилки СМС, а сам механізм розсилки (чи то БОТ, чи СМС-провайдер, чи дзвінок) реалізовується силами замовника.

Тобто Замовник своїми силами розробляє скрипт та вирішує на якому хостингу розмістити його. Цей скрипт буде отримувати дані з Unipro, і вже він буде надсилати СМС чи то через БОТ, чи через СМС-провайдерів, чи іншим шляхом.

Можливість допомогти в розробці скрипта та розміщенню його на хостингу уточнюйте в технічні підтримці.

Опис UniproSMSProviderAPI для програмістів

UniproSMSProviderAPI - API для SMS-підтвердження під час списання бонусів.

Щоб надіслати СМС програма виконує GET запит, з наступними параметрами:

Параметр	Приклад	Опис
tel	0675065980	Номер телефону клієнта
bonus	234.45	Кількість бонусів, яку планують списати
token	12-34-45-78-90	Будь-яка стрічка, яка буде Ідентифікатором магазину, або це може бути код доступу, щоб ваш сервіс розпізнавав, який саме магазин надсилає СМС
msg	Щоб використати бонуси=234.45, повідомте код: [code].	Це повідомлення клієнту в налаштуваннях програми касира. Замість слова “[code]” - вставте код який ви надішлете клієнту. Цей параметр можна ігнорувати і надсилати інший текст

Приклад GET запиту: https://test-json.unipro.ua/sms.php?tel=0670000000&bonus=234.45&token=12-34-56-78-90&msg=To_activate_bonuses_say_the_code.

У відповідь ваш сервіс має надіслати JSON:

Поле	Тип	Опис
ErrorCode	Ціле число	0 - все ОК. Будь-який інший код - означає помилку, номер на ваш розсуд
SMSCode	Стрічка	Код, який надісланий клієнту в SMS
Message	Стрічка	Повідомлення для продавця. Може бути пустим. Якщо ErrorCode=0, то повідомлення синього кольору, в іншому випадку - червоного. Наприклад “Клієнт тимчасово заблокований.”

Успішна відповідь:

{
 "ErrorCode": 0,
 "SMSCode": "1860",
 "Message": "Have a nice day"
}

Відповідь з помилкою:

{
 "ErrorCode": 209,
 "SMSCode": "",
 "Message": "Клієнт тимчасово заблокований"
}

Наш тестовий cкрипт, може допомогти в тестуванні та розробці:
Отримати JSON: https://test-json.unipro.ua/sms.php?tel=0670000000&bonus=789.00&token=12-34-56-78-90&msg=To_activate_bonuses_say_the_code.
Переглянути значення, які скрипт генерував: https://test-json.unipro.ua/sms.php