<< Click to Display Table of Contents >> Navigation:  Додаткові функції > Підключення банківського терміналу > Інструкції підключення банківських терміналів > OschadPAY

Інструкція з налаштування підключення з пристроями, що підтримують протокол/додаток OschadPAY

Поєднання механізму оплати платіжною карткою в Торгсофт за протоколом OschadPAY передбачає налаштування підключення з пристроями, на яких встановлено андроїд-додаток "OschadPAY" (від Ощадбанку України). Ця програма може бути встановлена ​​як на POS-терміналі на базі ОС Андроїд, так і на смартфоні, що підтримує технологію безконтактної оплати NFC (у цьому випадку смартфон виступає в ролі банківського POS-термінала). Крім смартфона необхідно, щоб у робочому каталозі Торгсофт (там, де знаходиться ехе-файл) знаходилися файли libeay32.dll та libssl32.dll.

 

Необхідно завантажити та встановити на смартфон додаток OschadPAY, попередньо узгодивши всі питання з банком (договір, оформлення особистого кабінету тощо). Банк безпосередньо або через особистий кабінет повинен надати користувачеві Токен авторизації та Ідентифікатор клієнта (ClientID). Після налаштування програми на смартфоні, переконавшись, що все коректно працює, можна переходити до наступного етапу, а саме підключення в Торгсофт.

При додаванні банківського термінала (Налаштування - Параметри - Додаткові опції - Банківський термінал) в полі Тип банківського терміналу оберіть Смартфон(Ощадбанк) або протокол ОschadPAY (рисунок 1).

 

Рисунок 1 - Додавання банківського терміналу Смартфон(Ощадбанк)

 

Слід заповнити поля Токен авторизації та Ідентифікатор клієнта. При початковому налаштуванні, якщо Мерчант невідомий, можна скористатися кнопкою Отримати мерчант торговця (біля відповідного поля).  Поле Каталог логу є обов'язковим до заповнення, в якому буде зберігатися файл лога роботи терміналу BankTerminalOschadPAY.log, а також файл ApiDirectiriesJSON.txt у форматі JSON, який є API довідником і використовується для розшифровки кодів помилок, що повертаються терміналом. Цей файл створюється в момент отримання інформації по терміналу та бажано його періодично оновлювати.

При налаштування операції банківського терміналу потрібно додати один Тип операції -  Оплата_Повернення (рисунок 2).

Рисунок 2 - додавання операції банківського термінала для Ощадбанку

 

Ідентифікатор терміналу - TerminalID можна отримати, викликавши дію Отримати інформація з терміналу у списку терміналів (рисунок 3).

Рисунок 3 - Отримати інформацію про термінал

 

Особливістю даного протоколу є формат зберігання інформації про транзакцію, який використовується при поверненні. Це рядок виду:

517131169475_PXXYKlnMd7M6WQlWXTydLzIrKvP6oN3v_33488

яка є групою з 3-х даних, розділених символом «_»:

•перша група - це RRN транзакції (безпосередньо для повернення необов'язковий);

•друга група - токен транзакції;

•третя група - ідентифікатор касира.

У такому вигляді дані зберігаються у фінансовому документі та використовуються для повернення. Така особливість ідентифікації транзакції оплати зумовлює обмеження для повернення - неможливо виконати повернення в ручному режимі за чеком (навіть якщо воно є). Повернення з Торгсофт можливе виключно за чеком реалізації та пов'язаним з ним фінансовий документом.