# Про оплату через бот

ConnectiveOne підтримує інтеграцію з платіжними системами для прийняття оплат безпосередньо в боті без додаткової інтеграції з сайтом. Це дозволяє створювати повноцінні e-commerce рішення в месенджерах.

## Контекст і проблема

У багатьох сценаріях потрібно приймати оплату від користувачів:
- Продаж товарів або послуг
- Підписки та рекурентні платежі
- Донорські збори
- Поповнення балансу

Інтеграція з платіжними системами вирішує цю задачу, дозволяючи приймати оплату безпосередньо в боті.

## Основні концепції

### Підтримувані способи оплати

**Liqpay (всі канали):**
- Працює для Telegram, Viber, Facebook Messenger, Widget
- Універсальне рішення для всіх каналів

**Apple Pay & Google Pay (тільки Viber):**
- Працює тільки для каналу Viber
- Нативна інтеграція з мобільними платіжними системами

### Загальний workflow оплати

1. Користувач обирає товар/послугу в боті
2. Бот формує платіжне посилання
3. Користувач переходить на сторінку оплати
4. Після успішної оплати користувач повертається в бот
5. Бот обробляє результат оплати та надає доступ до послуги/товару

## Варіанти підходів

### Liqpay vs Apple Pay & Google Pay

**Liqpay:**
- ✅ Плюси: Працює для всіх каналів, універсальне рішення
- ❌ Мінуси: Потрібна реєстрація в Liqpay

**Apple Pay & Google Pay:**
- ✅ Плюси: Нативна інтеграція, зручність для користувачів
- ❌ Мінуси: Працює тільки для Viber, потребує налаштування

**Чому використовуємо обидва підходи:**
Liqpay забезпечує універсальність для всіх каналів, а Apple Pay & Google Pay надають кращий користувацький досвід для Viber користувачів.

## Прийняті рішення

### Обробка результатів оплати

Після оплати бот отримує callback з результатом. Необхідно налаштувати обробку:
- Успішна оплата — надання доступу до послуги
- Помилка оплати — інформування користувача
- Скасування оплати — повернення до вибору

### Безпека платежів

Всі платежі обробляються через безпечні платіжні системи з підтримкою HTTPS та шифрування даних. Дані карток не зберігаються в системі ConnectiveOne.

## Наслідки для користувачів і імплементації

### Для інтеграторів

При інтеграції оплати важливо:

1. **Налаштувати платіжну систему** — зареєструватися в Liqpay або налаштувати Apple Pay & Google Pay
2. **Обробити результати оплати** — налаштувати callback обробку для різних результатів
3. **Надати доступ після оплати** — автоматично надавати доступ до послуги/товару після успішної оплати
4. **Інформувати користувача** — повідомляти про статус оплати та наступні кроки

### Типові помилки

**Помилка:** Оплата не проходить  
**Проблема:** Не налаштована платіжна система або неправильні параметри  
**Рішення:** Перевірити налаштування платіжної системи та параметри запиту

**Помилка:** Користувач не отримує доступ після оплати  
**Проблема:** Не налаштована обробка callback після успішної оплати  
**Рішення:** Додати обробку callback та автоматичне надання доступу

**Помилка:** Оплата працює тільки для одного каналу  
**Проблема:** Використано Apple Pay & Google Pay замість Liqpay  
**Рішення:** Використати Liqpay для підтримки всіх каналів

## Пов'язані документи

> 💡 **Примітка:** Детальні інструкції по інтеграції платіжних систем доступні в Swagger UI або технічній документації.