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

Блоки оплати чат-бота виставляють рахунок через платіжну систему, підключену до цього бота. Підключення називається інтеграцією й зберігається в налаштуваннях бота: «Налаштування» → вкладка «Інтеграції».

Як відкрити вікно інтеграції, зберегти й видалити її — на сторінці Інтеграції. Тут — те, що стосується платіжних систем: які поля заповнювати і що робити з адресою Webhook.

Примітка

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

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

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

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

Ю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 — її описано на сторінці Інтеграції.

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

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

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

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

Далі#

• Налаштування самих блоків оплати — у розділі Приймання оплати.
• Які дані йдуть у чек — на сторінці Чеки.
• Де дивитися виставлені й оплачені рахунки — на сторінці Платежі та замовлення бота.