Інтеграція PayLink

Щоб інтегрувати платіжні термінали в CleverBox:CRM, скористайтеся сервісом  Checkbox PayLink 
Це дозволить вам легко та швидко обробляти платежі, забезпечуючи зручний процес для ваших клієнтів


Крок 1: Встановлення та налаштування PayLink Backhand Index Pointing Down

Pushpin Встановіть програму PayLink від Checkbox та додайте до неї платіжні термінали відповідно до офіційної  ➝ Інструкції по встановленню 
Якщо у вас виникли питання щодо встановлення або роботи PayLink, звертайтеся до служби підтримки Checkbox.
Check Mark Button Перевірка роботи терміналуПісля встановлення обов’язково перевірте його роботу через особистий кабінет CHECKBOX. Якщо тестова оплата проходить успішно, можна переходити до підключення терміналу в CleverBox:CRM.


Крок 2: Додавання терміналу в CleverBox:CRM Backhand Index Pointing Down

Small Blue Diamond Відкрийте меню Ще → Доповнення → Інтеграція з Checkbox → вкладка "Термінали"Small Blue Diamond Натисніть кнопку "+Додати термінал"

Заповніть наступні поля:

1️⃣ ID терміналу

Small Blue Diamond Де знайти? Відкрийте програму PayLink, знайдіть ID терміналу в налаштуваннях, скопіюйте його та вставте у відповідне поле.

2️⃣ IP-адреса

Small Blue Diamond За замовчуванням: 127.0.0.1 (локальний хост)Small Blue Diamond Якщо PayLink встановлено на іншому пристрої в локальній мережі, вкажіть його IP-адресу. Це потрібно для коректного обміну даними між системами.

3️⃣ Порт

Small Blue Diamond Вкажіть порт 9020 – через нього PayLink буде підключатися до терміналу.

4️⃣ Вид оплати

Small Blue Diamond Виберіть спосіб оплати, який буде прив’язаний до цього терміналу. Він використовуватиметься для обліку транзакцій та друку чеків.


Крок 3: Завершення підключення Backhand Index Pointing Down

Check Mark Button Натисніть "APPLY" для збереження налаштувань.Check Mark Button Натисніть "Підключити" для активації терміналу в системі.
Warning Зверніть увагу: Кнопка "Підключити" буде активною тільки на тому пристрої, де запущено програму PayLink, але налаштування можна вносити з будь-якого пристрою.


При підключенні платіжного терміналу через PayLink, у чек передаються обов’язкові поля для безготівкових платежів:
Credit Card Дані картки та банку:
card_mask – маска картки (до 19 символів)
bank_name – назва банку
payment_system – платіжна система
Bookmark Tabs Деталі транзакції:
auth_code – код авторизації банківської операції
rrn – унікальний ідентифікатор транзакції (Reference Retrieval Number)
receipt_no – номер банківського чека
🖥 Інформація про термінал:
terminal – дані про платіжний термінал
acquirer_and_seller – ідентифікатор еквайра та торгівця
Writing Hand Підпис у чеку:
signature_required – прапорець (true/false), що визначає, чи потрібен підпис власника картки та касира.



Що робити, якщо не вдається провести оплату через PayLink? Backhand Index Pointing Down


Якщо під час оплати ви бачите помилку:Small Blue Diamond "Оплата не здійснена!"Small Blue Diamond "Device config not found"
Це може означати, що налаштування терміналу виконані некоректно. Переконайтеся, що всі дані введені правильно.

Як перевірити налаштування терміналу? Magnifying Glass Tilted Left

1️⃣ Відкрийте Ліве меню у вашому застосунку.2️⃣ Перейдіть до Ще ➝ Доповнення ➝ Інтеграція Checkbox.3️⃣ Відкрийте вкладку "Термінали" та знайдіть у списку свій термінал.4️⃣ Натисніть на назву терміналу, щоб переглянути його налаштування.5️⃣ Переконайтеся, що ID терміналу вказано коректно – він має збігатися з тим, що ви отримали від постачальника послуг.6️⃣ Перевірте правильність IP-адреси пристрою, на якому встановлено PAYLINK. Вона має бути вказана точно, без пробілів чи зайвих символів.7️⃣ Додатковий тест підключення:
Pushpin Відкрийте веб-браузер та введіть наступну адресу:
http://127.0.0.1:9020/api/device/connect/{id-terminal}
де {id-terminal} замініть на ID вашого терміналу.
✔ Якщо все налаштовано правильно, з'явиться текст:
success:true
Це означає, що термінал підключено успішно та він відповідає по API.

Cross Mark Якщо ви бачите помилку "Сторінку не знайдено" або інший текст, це свідчить про проблему з підключенням. В такому разі рекомендуємо:
  • Перевірити, чи правильно вказано ID терміналу.
  • Переконатися, що PAYLINK запущений і працює коректно.
  • Перевірити, чи ваш пристрій знаходиться у тій самій мережі, що й термінал.
Якщо після перевірки підключення термінал все ще не працює, рекомендуємо звернутися до технічної підтримки Checkbox. Rocket