Інтеграція PayLink

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


Puzzle Piece Крок 1: Встановлення та налаштування PayLink

Pushpin Встановіть програму PayLink від Checkbox на комп’ютер або планшет, до якого підключено платіжний термінал.🛠 Скористайтеся офіційною інструкцією по встановленню  ➝ Інструкції по встановленню 
Speech Balloon Якщо виникають труднощі — звертайтеся до служби підтримки Checkbox.

Check Mark Button Перевірка роботи терміналу

Після встановлення:1️⃣ Увійдіть у особистий кабінет CHECKBOX.2️⃣ Проведіть тестову оплату через PayLink.3️⃣ Якщо транзакція успішна — можна переходити до підключення терміналу в CleverBox:CRM.


Puzzle Piece Крок 2: Додавання терміналу в CleverBox:CRM

Right Arrow Перейдіть: Ліве меню ➝ Ще ➝ Налаштування ➝ Checkbox ➝ вкладка "Термінали"Right Arrow Натисніть "+ Додати термінал"
Заповніть поля Backhand Index Pointing Down
1️⃣ ID терміналуSmall Blue Diamond Де знайти: відкрийте програму PayLink → у налаштуваннях знайдіть ID терміналу → скопіюйте та вставте у CRM.
2️⃣ IP-адресаSmall Blue Diamond За замовчуванням: 127.0.0.1 (якщо PayLink встановлено на тому ж пристрої).Small Blue Diamond Якщо PayLink працює на іншому пристрої в локальній мережі — введіть його IP-адресу.
3️⃣ ПортSmall Blue Diamond Вкажіть порт 9020 — стандартний для підключення PayLink.
4️⃣ Вид оплатиSmall Blue Diamond Оберіть, який саме тип оплати (наприклад, “Банківська картка”) буде прив’язаний до цього терміналу.


Puzzle Piece Крок 3: Завершення підключення

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), що визначає, чи потрібен підпис власника картки та касира.



Laptop Перед початком роботи перевірте, що:

Check Box with Check У системі CleverBox активна інтеграція з Checkbox PayLinkCheck Box with Check На комп’ютері запущена програма PayLinkCheck Box with Check З’єднання з терміналом успішне (зелена іконка біля виду оплати)


Credit Card Як провести оплату через термінал

1️⃣ У вікні оплати натисніть на вид оплати, до якого прив’язано термінал.2️⃣ Якщо підключення активне — біля способу оплати з’явиться зелена іконка терміналу.3️⃣ Вкажіть суму оплати або розподіліть суму між кількома способами.4️⃣ Натисніть "Сплатити".5️⃣ З’явиться вікно очікування оплати, а на терміналі — сума до сплати.6️⃣ Клієнт прикладає або вставляє картку Credit Card


Gear Як працює інтеграція CleverBox ↔ PayLink ↔ Термінал

1️⃣ CleverBox передає дані про оплату через API у PayLink.2️⃣ PayLink надсилає запит до терміналу.3️⃣ Термінал проводить транзакцію і надсилає результат до PayLink.4️⃣ PayLink передає результат назад у CleverBox.5️⃣ CleverBox фіксує оплату і друкує чек через Checkbox.
Counterclockwise Arrows Button Якщо на будь-якому етапі:
  • термінал не відповів PayLink,
  • PayLink не відповів CleverBox,
  • або втрачено з’єднання,
CleverBox не отримає підтвердження та не завершить оплату.У такому випадку система покаже попередження, щоб уникнути подвійних транзакцій Warning


Compass Якщо виникла помилка під час оплати

Система відобразить повідомлення про збій.Ви можете:Repeat Button Повторити спробу — щоб надіслати запит знову.Raised Hand Провести оплату вручну — ввести суму на терміналі самостійно.
Light Bulb Після успішної транзакції CleverBox автоматично отримує підтвердження, і чек зберігається у Checkbox.


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

1️⃣ Відкрийте Ліве меню ➝ Ще ➝ Налаштування ➝ Checkbox ➝ вкладка "Термінали"2️⃣ Знайдіть потрібний термінал.3️⃣ Натисніть на його назву, щоб переглянути деталі.4️⃣ Перевірте:
  • чи правильний ID терміналу
  • чи вказано коректну IP-адресу пристрою з PayLink
  • чи встановлено порт 9020
5️⃣ Виконайте тест підключення — натисніть кнопки "Перевірити підключення" та "Перевірити налаштування".
Check Mark Button Якщо все вірно — система отримає відповідь від PayLink із статусом терміналу.Cross Mark Якщо з’явиться error або timeout — немає зв’язку між вашим пристроєм і PayLink (перевірте IP, порт або мережу).

Порада від CleverBox:Після налаштування протестуйте оплату на невелику суму. Якщо чек фіскалізувався і транзакція пройшла — інтеграція активна Party Popper