docs: ТЗ на настройку бота (БАЗА) + описание приёма оплаты в боте
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Kenik
Binary file not shown.
@@ -0,0 +1,148 @@
|
||||
# Приём оплаты через чат-бота ИКП (ВКонтакте)
|
||||
|
||||
Документ для согласования. Описывает, **как будет проходить оплата** через бота,
|
||||
и **что для этого нужно со стороны компании** (бухгалтерия / руководство).
|
||||
|
||||
---
|
||||
|
||||
## 1. Что предлагается
|
||||
|
||||
Дать клиенту возможность **оплатить услугу прямо в переписке с ботом ВКонтакте** —
|
||||
через Систему быстрых платежей (СБП) по QR-коду или ссылке в банковское приложение.
|
||||
Приём платежей — через уже используемый сервис **ЮKassa**. Деньги поступают на
|
||||
**расчётный счёт компании**, как и при обычной оплате через ЮKassa.
|
||||
|
||||
---
|
||||
|
||||
## 2. Как это будет происходить (пошагово)
|
||||
|
||||
**Со стороны клиента:**
|
||||
1. Клиент оформляет заявку в боте и выбирает услугу.
|
||||
2. Бот присылает прямо в чат **сумму к оплате**, **QR-код** и **кнопку «Оплатить»**
|
||||
(ссылка открывает приложение его банка — Сбер / ВТБ / Альфа / Т-Банк и др.).
|
||||
3. Клиент оплачивает в своём банке по СБП (сканирует QR или жмёт кнопку).
|
||||
4. Бот сам узнаёт, что оплата прошла, и присылает: **«Оплата получена ✅»** и
|
||||
инструкцию, что делать дальше (например, время занятия / контакт тренера).
|
||||
|
||||
**Со стороны системы (автоматически):**
|
||||
1. Бот создаёт платёж в ЮKassa на нужную сумму.
|
||||
2. ЮKassa формирует QR/ссылку СБП и (при необходимости) **фискальный чек**.
|
||||
3. Бот отслеживает статус платежа и, как только он «оплачен», подтверждает клиенту
|
||||
и **уведомляет менеджера** о поступившей оплате.
|
||||
|
||||
> Важно: клиент **не переходит на посторонние сайты** — оплата идёт через QR/ссылку
|
||||
> в его банковском приложении. Это снижает риск сбоев на мобильном интернете.
|
||||
|
||||
---
|
||||
|
||||
## 3. Куда поступают деньги
|
||||
|
||||
- Платёж проходит через **ЮKassa** (тот же сервис, что используется сейчас).
|
||||
- Средства зачисляются на **расчётный счёт компании** по условиям действующего
|
||||
договора с ЮKassa. Никаких новых счетов/кошельков заводить не требуется.
|
||||
- Комиссия — по тарифу ЮKassa/СБП (уточняется в кабинете ЮKassa).
|
||||
|
||||
---
|
||||
|
||||
## 4. Где хранятся данные о платежах и как их получают
|
||||
|
||||
**Хранение (три уровня):**
|
||||
- **ЮKassa — основной финансовый реестр.** Полные данные каждого платежа
|
||||
(плательщик, сумма, дата, статус, чек) хранятся в кабинете ЮKassa. Это
|
||||
авторитетный источник для бухгалтерии и налоговой.
|
||||
- **База сайта (infocyber.pro) — единый учёт.** Бот дублирует запись об оплате
|
||||
(кто / когда / сколько / за что / статус) в базу сайта, чтобы платежи были в одном
|
||||
месте с остальными заявками компании.
|
||||
- **База бота — рабочая связка.** Локально бот хранит связь «платёж ↔ клиент/заявка»
|
||||
для своей логики (подтверждение оплаты, сверка).
|
||||
|
||||
**Получение данных (максимально безопасно):**
|
||||
- Основной способ — **кабинет ЮKassa**: доступ по ролям, официальные выгрузки в
|
||||
Excel/1С, чеки. Здесь бухгалтерия берёт данные для отчётности.
|
||||
- Дополнительно — **выгрузка из базы сайта** штатными средствами (как по остальным
|
||||
заявкам).
|
||||
- Финансовые данные **не выводятся в переписку ВКонтакте** — это небезопасный канал.
|
||||
Чат используется только для уведомления клиента об успешной оплате.
|
||||
|
||||
> Примечание по реализации: запись в базу сайта требует доступа к ней (тип СУБД,
|
||||
> структура таблиц, учётные данные) — это отдельный пункт согласования с
|
||||
> администратором сайта.
|
||||
|
||||
## 5. Что нужно подтвердить со стороны компании
|
||||
|
||||
Это ключевой раздел — **реализуемость зависит от этих пунктов**:
|
||||
|
||||
1. **Договор с ЮKassa действует** и позволяет приём платежей от физлиц. ✔/�’
|
||||
2. **Подключён СБП** в кабинете ЮKassa (отдельная активация). Без него QR/ссылку
|
||||
по СБП выпустить нельзя. ✔/✗
|
||||
3. **Фискальные чеки (54-ФЗ):** при оплате услуги физлицом закон требует выдавать
|
||||
чек. Нужно подтвердить, что:
|
||||
- подключена онлайн-касса (своя или облачная от ЮKassa), и
|
||||
- бухгалтерия согласовала **состав чека** (наименование услуги, ставка НДС/без НДС,
|
||||
признак предмета/способа расчёта). ✔/✗
|
||||
4. **Юр. статус получателя** (ИП / ООО / самозанятый) — под него настраиваются чеки и
|
||||
налогообложение. ✔/✗
|
||||
5. **Прайс для оплаты:** точные суммы за конкретные услуги (сейчас в боте указано
|
||||
«от 870 ₽» — для оплаты нужна фиксированная цена позиции). ✔/✗
|
||||
6. **Доступы ЮKassa** (идентификатор магазина и секретный ключ) — выдаются
|
||||
разработчику для настройки; хранятся в защищённом конфиге, в открытый код не попадают.
|
||||
|
||||
---
|
||||
|
||||
## 6. Что делает бот, а что — нет
|
||||
|
||||
**Бот делает:**
|
||||
- создаёт платёж, показывает QR/ссылку, ловит подтверждение оплаты, сообщает клиенту
|
||||
и менеджеру, ведёт учёт оплат.
|
||||
|
||||
**Бот НЕ делает (это на стороне ЮKassa/бухгалтерии):**
|
||||
- не хранит деньги и данные карт (всё в контуре ЮKassa — это безопаснее и по 152-ФЗ);
|
||||
- не формирует чек самостоятельно — чек выпускает ЮKassa/касса по данным, которые
|
||||
согласует бухгалтерия;
|
||||
- не считает налоги.
|
||||
|
||||
---
|
||||
|
||||
## 7. Риски и как они закрываются
|
||||
|
||||
- **Клиент не оплатил / передумал** — платёж имеет срок (например, 15 минут), после
|
||||
чего отменяется; бот предложит повторить.
|
||||
- **Сбой связи** — бот перепроверяет статус платежа; при успешной оплате подтверждение
|
||||
придёт, даже если клиент закрыл чат.
|
||||
- **Сверка** — по каждой оплате менеджер получает уведомление; все платежи видны в
|
||||
кабинете ЮKassa (для бухгалтерии — привычный источник данных).
|
||||
|
||||
---
|
||||
|
||||
## 8. Что нужно для старта (резюме)
|
||||
|
||||
| # | Пункт | Ответственный | Статус |
|
||||
|---|-------|---------------|--------|
|
||||
| 1 | Действующий договор ЮKassa | Бухгалтерия/руководство | |
|
||||
| 2 | Подключён СБП в ЮKassa | Бухгалтерия/ЮKassa | |
|
||||
| 3 | Онлайн-касса + состав чека (54-ФЗ) | Бухгалтерия | |
|
||||
| 4 | Юр. статус и налоговый режим | Бухгалтерия | |
|
||||
| 5 | Фиксированные цены услуг | Руководство | |
|
||||
| 6 | Доступы ЮKassa (тестовые и боевые) | Руководство → разработчик | |
|
||||
| 7 | Доступ к базе сайта (для записи платежей) | Администратор сайта | |
|
||||
|
||||
**Вывод:** технически всё реализуемо и уже частично готово (в боте есть оформление
|
||||
заявок и уведомления). Оставшиеся вопросы — **организационные** (СБП, чеки, доступы).
|
||||
Как только пункты 1–7 подтверждены, внедрение занимает ограниченное время.
|
||||
|
||||
---
|
||||
|
||||
## 9. Что нужно от администратора сайта (для записи платежей в базу сайта)
|
||||
|
||||
Чтобы платежи дублировались в базу сайта (единый учёт с заявками), от администратора
|
||||
**infocyber.pro** потребуется:
|
||||
- **тип СУБД** (MySQL / PostgreSQL / иное);
|
||||
- **способ подключения** — хост, порт, логин, пароль (или API сайта, если прямой доступ
|
||||
к базе не предоставляется);
|
||||
- **куда записывать** — таблица и её структура для платежей.
|
||||
|
||||
Пока этих доступов нет, внедрение возможно **поэтапно**:
|
||||
- **Этап 1.** Оплата полностью работает на базе бота + ЮKassa (приём платежей,
|
||||
подтверждение, уведомление менеджера, учёт). Функционально — всё готово к работе.
|
||||
- **Этап 2.** Добавляется дублирование платежей в базу сайта — как только администратор
|
||||
сайта предоставит доступ и структуру.
|
||||
Reference in New Issue
Block a user