> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roxydesk.com/llms.txt
> Use this file to discover all available pages before exploring further.
# LiqPay
# Підключення та налаштування LiqPay
LiqPay — платіжна система для приймання онлайн-платежів. Після підключення Roxy Desk може використовувати магазин LiqPay для створення платежів і отримання інформації про їхній стан.
Для налаштування знадобиться пара API-ключів одного магазину LiqPay: публічний і приватний.
> **Важливо:** приватний API-ключ використовується для підпису запитів і перевірки відповідей LiqPay. Не передавайте його стороннім особам і не додавайте до задач, листування, скриншотів або відкритої документації. Якщо ключ став відомий стороннім, замініть його в LiqPay та одразу оновіть налаштування Roxy Desk.
## Перед початком
Переконайтеся, що:
* у вас є обліковий запис LiqPay і доступ до потрібного магазину;
* магазин налаштований для тестування або активований для приймання реальних платежів;
* ви маєте доступ до налаштувань і API-ключів магазину;
* ви маєте право редагувати інтеграції в Roxy Desk.
### Виберіть режим роботи
LiqPay створює для магазину дві пари ключів:
* тестові ключі — починаються з `sandbox_`, використовуються лише для перевірки інтеграції, без реального списання та зарахування коштів;
* бойові ключі — використовуються для реальних платежів після активації магазину.
Спочатку рекомендується перевірити інтеграцію з тестовими ключами. Після успішного тесту замініть обидва значення на бойову пару. Не поєднуйте публічний ключ з однієї пари з приватним ключем з іншої. Правила тестування наведено в [офіційній документації LiqPay](https://www.liqpay.ua/doc/api/testing).
### Отримайте ключі LiqPay
1. Увійдіть до особистого кабінету LiqPay.
2. Виберіть магазин, через який Roxy Desk має приймати платежі.
3. Відкрийте налаштування магазину та знайдіть його API-ключі.
4. Виберіть тестову або бойову пару відповідно до потрібного режиму.
5. Скопіюйте `public_key` і `private_key` окремо, не змінюючи символи.
6. Зберігайте приватний ключ лише в захищеному місці до завершення налаштування.
Публічний ключ ідентифікує магазин. Приватний ключ використовується для формування підпису запитів і не повинен розкриватися користувачам або третім особам. Технічне призначення ключів описано в [документації LiqPay API](https://www.liqpay.ua/doc/api/internet_acquiring/widgets).
## 1. Відкрийте розділ «Інтеграції»
У лівому меню розгорніть розділ «Адміністрування» і натисніть «Інтеграції».
Відкриється сторінка зі списком доступних інтеграцій. У верхній частині сторінки показано загальну кількість інтеграцій, а також кількість активних і неактивних сервісів.
## 2. Знайдіть інтеграцію LiqPay
Знайдіть у списку картку «LiqPay».
У картці відображається поточний стан інтеграції:
* «Активний» — інтеграція ввімкнена;
* «Неактивний» — інтеграція вимкнена або ще не налаштована.
Праворуч від стану розташоване меню дій із трьома крапками.
## 3. Відкрийте форму редагування
Натисніть кнопку з трьома крапками в картці LiqPay і виберіть «Редагувати».
Відкриється форма «Редагування інтеграції LiqPay». Якщо потрібно лише перевірити поточні налаштування без внесення змін, у меню картки виберіть «Переглянути».
## 4. Заповніть налаштування LiqPay
Заповніть усі обов’язкові поля форми.
### Тип інтеграції
Переконайтеся, що в полі «Тип інтеграції» вибрано значення «Платіжна система». Воно визначає, що сервіс використовується для проведення платежів.
### Стан
Виберіть потрібний стан:
* «Активний» — щоб Roxy Desk міг використовувати LiqPay для платежів;
* «Неактивний» — щоб зберегти налаштування, але тимчасово не використовувати інтеграцію.
Для тестування або завершення підключення виберіть «Активний».
### Публічний API-ключ
Вставте в поле «Публічний API-ключ» значення `public_key` вибраного магазину LiqPay.
Під час заповнення:
* скопіюйте ключ повністю;
* перевірте, що перед ключем і після нього немає пробілів;
* для тестового режиму використовуйте ключ із префіксом `sandbox_`;
* переконайтеся, що ключ належить тому самому магазину та режиму, що й приватний ключ.
### Приватний API-ключ
Вставте в поле «Приватний API-ключ» відповідне значення `private_key`.
Під час заповнення:
* не вводьте публічний ключ повторно;
* не використовуйте пароль від кабінету LiqPay;
* не змішуйте тестовий і бойовий ключі;
* не передавайте приватний ключ технічній підтримці у відкритому повідомленні;
* після заміни ключів у LiqPay оновіть обидва значення в Roxy Desk.
## 5. Збережіть налаштування
Перед збереженням перевірте:
* тип інтеграції — «Платіжна система»;
* стан — «Активний»;
* публічний і приватний ключі належать одному магазину;
* обидва ключі належать одному режиму: тестовому або бойовому;
* значення скопійовані без зайвих пробілів.
Натисніть «Зберегти» в нижній частині форми.
Якщо система показує помилку біля поля, перевірте відповідне значення та повторіть збереження. Не публікуйте скриншот форми з незамаскованим приватним ключем.
## 6. Перевірте стан інтеграції
Поверніться до картки LiqPay у списку інтеграцій.
Якщо під час налаштування було вибрано «Активний», картка також має показувати стан «Активний». Це означає, що налаштування збережені й Roxy Desk може використовувати LiqPay у платіжних сценаріях.
Для додаткової перевірки відкрийте меню картки, виберіть «Переглянути» та переконайтеся, що стан і публічний ключ збережені правильно. Приватний ключ не повинен відображатися у відкритому вигляді.
## 7. Проведіть тестовий платіж
Якщо підключено тестову пару ключів:
1. Відкрийте в Roxy Desk сценарій, у якому доступна оплата через LiqPay.
2. Створіть тестовий платіж із тестовими даними з документації LiqPay.
3. Завершіть або відхиліть оплату відповідно до сценарію перевірки.
4. Переконайтеся, що платіж з’явився в LiqPay.
5. Перевірте, що Roxy Desk отримав правильний стан платежу.
Тестові ключі `sandbox_` не виконують реального списання або зарахування коштів. Після успішного тестування замініть обидва ключі на бойову пару, збережіть налаштування та повторно перевірте платіжний сценарій.
## Як змінити або вимкнути інтеграцію
1. Відкрийте Адміністрування → Інтеграції.
2. Знайдіть картку LiqPay.
3. Натисніть кнопку з трьома крапками та виберіть «Редагувати».
4. Замініть обидва API-ключі або встановіть стан «Неактивний».
5. Натисніть «Зберегти».
Після вимкнення Roxy Desk не повинен створювати нові платежі через LiqPay до повторної активації. Вимкнення інтеграції не скасовує платежі, які вже були створені в LiqPay.
## Якщо платіж не створюється або його стан не оновлюється
Перевірте налаштування у такому порядку:
1. Переконайтеся, що картка LiqPay має стан «Активний».
2. Повторно скопіюйте обидва ключі з налаштувань потрібного магазину LiqPay.
3. Перевірте відсутність зайвих пробілів у полях.
4. Переконайтеся, що обидва ключі належать одній парі та одному режиму.
5. Для тестового платежу використовуйте два ключі з префіксом `sandbox_` і тестові платіжні дані.
6. Для реального платежу перевірте, що магазин активований, а в Roxy Desk збережена бойова пара ключів.
7. Знайдіть операцію в кабінеті LiqPay та перевірте її стан.
8. Якщо платіж успішний у LiqPay, але його стан не оновився в Roxy Desk, передайте підтримці ідентифікатор замовлення або платежу, дату й приблизний час операції. Не надсилайте приватний API-ключ.
LiqPay передає оновлення стану платежу серверним callback-запитом. Справжність такого запиту має перевірятися за підписом; технічний порядок описано в [офіційній документації LiqPay про callback](https://www.liqpay.ua/doc/api/callback).