# Платіжні системи бота

[Блоки оплати](https://support.watbot.org/uk/chatbots/blocks/payments) чат-бота виставляють рахунок через платіжну систему, підключену до цього бота. Підключення називається інтеграцією й зберігається в налаштуваннях бота: «Налаштування» → вкладка «Інтеграції».

Як відкрити вікно інтеграції, зберегти й видалити її — на сторінці [Інтеграції](https://support.watbot.org/uk/chatbots/settings/integrations). Тут — те, що стосується платіжних систем: які поля заповнювати і що робити з адресою Webhook.

> [!NOTE]
> Підключення з вкладки «Прийом оплат» у налаштуваннях проєкту на блоки оплати бота не діють: вони потрібні магазину та онлайн-школі. Їх описано на сторінці [Платіжні системи проєкту](https://support.watbot.org/uk/payments/project-accounts).

## Загальні правила

- **У кожного бота свої інтеграції.** У копію бота вони не переносяться — підключіть систему в копії заново.
- **Одна система — одне підключення.** До бота можна підключити кілька різних платіжних систем, але кожну — один раз.
- **Валюта задається в інтеграції,** а не в блоці оплати. У систем, які працюють в одній валюті, поля валюти немає.
- **Адреса Webhook.** Якщо після збереження у вікні інтеграції з'явилася вкладка «Webhook», скопіюйте адресу з неї в особистий кабінет платіжної системи. За цією адресою система повідомляє бота про оплату — без неї вихід «Оплата успішна» блоку не спрацює.
- **Ключі видно співробітникам.** Вікно інтеграції відкриває власник бота і співробітник із правом «Налаштування бота» — надавайте це право лише тим, кому довіряєте доступ до каси.
- **Потрібна підписка Pro.** Вкладка «Інтеграції» працює лише з нею.

![Вікно платіжної інтеграції бота](https://support.watbot.org/_media/uk/11-payments/_images/bot-integration.webp?v=1791781231)

## Що вводити для кожної системи

### ЮKassa

На вкладці «Основне»:

- «Shop ID» і «Секретний ключ» — з кабінету ЮKassa;
- «Код валюти» — трилітерний код, за замовчуванням `RUB`;
- «Система оподаткування» і «Ставка ПДВ» — потрапляють у чек.

Після збереження з'являються ще дві вкладки. На вкладці «Webhook» — адреса, яку потрібно вказати як URL для сповіщень у налаштуваннях ЮKassa. Вкладку «Сповіщення» описано нижче.

Особливості:

- Чек передається з кожним платежем, тому боту потрібен номер телефону або пошта контакту.
- Отримавши повідомлення, платформа сама перевіряє платіж у ЮKassa ключами цієї інтеграції. Оплата зараховується, лише якщо ЮKassa підтверджує статус, суму й валюту.
- Якщо ЮKassa повідомляє про скасування, платіж у боті отримує статус «Скасовано».

### ЮMoney

Єдине поле — «Номер гаманця». Після збереження на вкладці «Webhook» з'явиться адреса: укажіть її в налаштуваннях HTTP-повідомлень гаманця ЮMoney.

Особливості:

- Рахунок виставляється в рублях.
- Оплата зараховується, лише якщо з платника списано не менше за суму рахунку. Переказ, захищений кодом протекції, і переказ, який ще не прийнято, не зараховуються.
- Дані для чека не передаються.

### Robokassa

На вкладці «Основне»:

- «Країна інтеграції магазину» — «Росія» або «Казахстан». Від неї залежить валюта рахунку: рублі або тенге;
- «Ідентифікатор магазину», «Пароль #1» і «Пароль #2» — з технічних налаштувань магазину в Robokassa;
- «Система оподаткування» і «Ставка ПДВ»;
- перемикач «Надсилати чеки».

Після збереження на вкладці «Webhook» з'явиться адреса: додайте її в поле Result Url у технічних налаштуваннях магазину в кабінеті Robokassa.

Особливості:

- Повідомлення перевіряється за «Паролем # 2». Якщо його введено неправильно, оплата не зарахується.
- Тестові платежі Robokassa бот не зараховує.

### Cloudpayments

У вікні три вкладки.

- «Основне»: «Public ID», «Пароль для API», «Валюта» і перемикач «Двостадійна оплата».
- «Webhook»: адреса з'являється після збереження. У налаштуваннях сайту в кабінеті Cloudpayments увімкніть повідомлення про прийнятий платіж — Pay і Confirm — і вкажіть для них цю адресу.
- «Чек»: перемикач «Надсилати чек». Коли його ввімкнено, з'являються «Система оподаткування» і «Ставка ПДВ».

Особливості:

- Оплата зараховується, лише якщо сума в повідомленні збігається із сумою рахунку.
- Під час двостадійної оплати гроші спочатку блокуються на картці, а платформа сама підтверджує списання.
- Платіж, здійснений у тестовому режимі Cloudpayments, у списку платежів бота позначено «[TEST]».

### Т-Банк

Інтеграція називається «Інтернет-еквайринг від Т-Банку». Поля:

- «Термінал» і «Пароль» — з кабінету інтернет-еквайрингу;
- «Система оподаткування» і «Ставка ПДВ»;
- «Версія ФФД» — версія ФФД вашої онлайн-каси: 1.05 або 1.2;
- «Надсилати чек». Обов'язково ввімкніть надсилання, якщо підключено онлайн-касу.

Вкладки «Webhook» немає: адресу повідомлень Т-Банк отримує разом із кожним платежем, вказувати її в кабінеті банку не потрібно.

Особливості:

- Рахунок виставляється в рублях.
- Для чека потрібен номер телефону або пошта контакту.
- Відмова й закінчений строк оплати переводять платіж у статус «Скасовано», повернення — у статус «Повернено».

### Prodamus

Поля: «Сторінка магазину» — адреса вашої платіжної сторінки Prodamus, «Секретний ключ» і перемикач «Демо-режим» для пробних платежів.

Після збереження відкриється вкладка «Webhook»: додайте адресу з неї в налаштуваннях платіжної сторінки Prodamus.

### bePaid

На вкладці «Основне» — «Shop ID», «Secret key» і «Валюта». Вкладки «Webhook» немає: адресу повідомлень bePaid отримує разом із кожним платежем. Вкладку «Сповіщення» описано нижче.

Особливості:

- Якщо банк відхилив спробу оплати, покупець може спробувати ще раз на тій самій сторінці. Платіж отримує статус «Скасовано», лише коли минув строк рахунку.
- Дані для чека не передаються.

### LiqPay

Поля: «Публічний ключ», «Приватний ключ» і «Валюта» — долар, євро, рубль, гривня, білоруський рубль або тенге. Адресу повідомлень LiqPay отримує разом із кожним платежем, вкладки «Webhook» немає. Дані для чека не передаються.

### Crypto Pay

Єдине поле — «API Token». Після збереження відкриється вкладка «Webhook»: додайте адресу з неї у вашому @CryptoBot.

### JustClick

Оплата через JustClick працює на інтеграції JustClick — її описано на сторінці [Інтеграції](https://support.watbot.org/uk/chatbots/settings/integrations).

## Копія повідомлень на свій сервер

В інтеграцій ЮKassa, Robokassa і bePaid є вкладка «Сповіщення» з полем «URL для сповіщень». Укажіть у ньому адресу свого сервера — і платформа надсилатиме на неї інформацію про платежі бота. Це потрібно, якщо оплату враховує ще й ваша власна система.

- Сервер має відповісти кодом 200.
- Якщо відповідь інша, платформа повторює надсилання протягом доби, поступово збільшуючи паузу між спробами.

Поле необов'язкове: бот працює й без нього.

## Далі

- Налаштування самих блоків оплати — у розділі [Приймання оплати](https://support.watbot.org/uk/chatbots/blocks/payments).
- Які дані йдуть у чек — на сторінці [Чеки](https://support.watbot.org/uk/payments/receipts).
- Де дивитися виставлені й оплачені рахунки — на сторінці [Платежі та замовлення бота](https://support.watbot.org/uk/payments/bot-payments).
