Подключение за несколько минут
Пользователь заводит магазин и вставляет два поля сам. Заводить его вручную или писать нам за каждого тебе не нужно.
Для разработчиков
Как подключить BANKA BOT как платёжную систему в свой сервис.
Ты делаешь сервис, в котором много пользователей, и им нужно принимать оплату. Встрой BANKA BOT один раз, и каждый из них подключит его двумя полями, как подключают другие платёжные системы.
Открыть документациюСтатья для тех, кто пишет код. Собираешь бота в конструкторе и не программируешь? Вот инструкции по конструкторам чат-ботов: подключение без единой строки кода.
Кому это нужно
Сервисам, где оплату принимают твои пользователи
Если у тебя пользователи продают что-то своим клиентам, им нужна платёжная система. BANKA BOT встаёт рядом с теми, что у тебя уже есть, и подключается так же просто.
- Конструкторы чат-ботов и автоворонок
- CRM и сервисы продаж, где счёт выставляют клиенту
- Сервисы рассылок и уведомлений
- Платформы онлайн-школ и курсов
- Любой сервис, где пользователи продают свои товары или доступ
Как устроено
Твой пользователь это отдельный магазин
Ты не принимаешь деньги за пользователей и не делишь их потом. Каждый подключает свой магазин BANKA BOT, а твой сервис создаёт платежи его ключом и получает уведомления о его оплатах.
- У каждого пользователя свой магазин BANKA BOT, свой кабинет и свои деньги
- Общего ключа на всю платформу нет: чужие деньги через тебя не проходят
- Ключ и секрет пользователя хранятся у тебя на сервере, в браузер они не попадают
- Адрес для уведомлений ты передаёшь сам, пользователю ничего не нужно вставлять к нам
Схема
Пять шагов от настройки до оплаты
- 01
Пользователь заводит магазин
Открывает кабинет BANKA BOT в Telegram, в «Настройках» создаёт API-ключ и выпускает webhook-секрет. Ни ИП, ни счёт в банке ему не нужны.
- 02
Вставляет два поля у тебя
На экране настроек твоего сервиса: ключ и секрет. Кнопка «Проверить подключение» проверяет ключ без денег и показывает название его магазина.
- 03
Твой сервер создаёт платёж
Покупатель жмёт «Оплатить», и твой сервер создаёт платёж ключом этого пользователя: сумма, номер заказа, адрес для уведомления, ссылка возврата. Ссылка может вести обратно в бот.
- 04
Покупатель платит
Он открывает страницу оплаты и платит по СБП, картой или в USDT. Страница ждёт оплату час, потом нужен новый платёж.
- 05
Приходит уведомление, ты выдаёшь товар
Мы присылаем подписанное уведомление на твой адрес. Проверяешь подпись секретом этого пользователя и выдаёшь товар, только если платёж оплачен.
Для пользователя
Что он получает
Готовая страница оплаты
СБП, банковские карты и USDT на одной странице, её держим мы. Рисовать свою форму оплаты и хранить данные карт тебе не нужно.
Деньги у пользователя
Оплаты приходят в его кабинет, выводит он сам хоть каждый день, от 1 000 ₽. Ты не хранишь чужие остатки и не разбираешься с выплатами.
Комиссию платит магазин пользователя по обычным ставкам BANKA BOT, для тебя встраивание бесплатное.Ставки на странице тарифов
Перед запуском
Тестового режима нет
Отдельного тестового адреса и тестовых ключей у нас нет, ключ работает только с настоящими деньгами. Поэтому проверка идёт в два шага.
- Ключ без денегКнопка «Проверить подключение» спрашивает у нас, рабочий ли ключ, выпущен ли секрет и какие способы оплаты есть у магазина. Платёж при этом не создаётся.
- Весь путь настоящей оплатойЗаведи свой магазин BANKA BOT так же, как твой пользователь, и оплати свой же платёж на минимальную сумму. Проверишь платёж, уведомление и выдачу товара, а деньги придут к тебе.
Вопросы
Что обычно спрашивают
Сколько стоит встроить BANKA BOT?
Для твоего сервиса встраивание бесплатное, подключение и обслуживание магазина для пользователя тоже. С оплат пользователя удерживается обычная комиссия BANKA BOT, ставки на странице тарифов.
Есть тестовый режим или песочница?
Нет. Отдельного тестового адреса и тестовых ключей нет, ключ работает только с настоящими деньгами. Ключ проверяется без денег кнопкой «Проверить подключение», а весь путь от платежа до выдачи товара проверь настоящей оплатой на минимальную сумму в своём магазине: деньги придут к тебе же.
Покупатель нажал «Оплатить» ещё раз. Создавать новый платёж?
Нет, если это та же покупка: отдай ему тот же платёж, а если он уже оплачен, покажи, что оплата прошла. Новый платёж нужен для новой покупки, даже того же товара, и когда прежний истёк без оплаты. Что выдать за оплату, решает твой сервис по статусу конкретного платежа.
Можно принимать оплату за всех пользователей одним ключом?
Нет. Ключ принадлежит одному магазину, и все деньги пришли бы в него. Каждый пользователь подключает свой магазин и сам выводит свои деньги.
Что будет, если пользователь перевыпустит ключ?
Старый ключ перестаёт работать сразу, и запросы с ним получают ошибку «ключ не подошёл». Покажи пользователю, что ключ нужно обновить в настройках твоего сервиса, и проверь новый той же кнопкой.
Как попасть в список интеграций BANKA BOT?
Когда подключение прошло проверку настоящей оплатой, напиши в поддержку: название сервиса, ссылку на твою инструкцию для пользователей и снимок экрана настроек. Мы посмотрим подключение и расскажем, как добавить тебя в каталог интеграций.
Документация
Всё для кода в одном разделе
В документации есть раздел «Для разработчиков платформ»: экран настроек с готовыми подсказками, запросы, проверка подписи, повторы уведомлений и что показать пользователю при каждой ошибке.