Salebot.pro
Search
⌃K

Capusta.space

Сервис для приема платежей для сайтов, блогов, Telegram-каналов, стримов и других платформ.
Программа лояльности по промокоду Salebot:
Тариф 5% без ограничения срока действия и без необходимости подтверждать статус самозанятости.
Кроме прочего, без дополнительной платы и без комиссий сразу открывается доступ ко всем функциям сервиса: счета-тарифы, счета-подписки, доставка файлов после оплаты, виджеты для стримов, партнёрская программа.
Партнерская программа позволит подключать клиентов и получать дополнительный доход в виде 0,2% с их транзакций.

Регистрация

После регистрации в сервисе https://capusta.space/ в настройках вашего проекта (личный кабинет - значок шестеренки - API и Callbacks) появятся необходимые Вам данные: код проекта(project_code) - в примере это testsalebot токен для API - 71b7d77f-7c77-77cb-7f7a-bbc7a17c1e77 ваша почта, с которой вы проходили регистрацию - [email protected]
Также, помимо этих данных, в системе Capusta Вам потребуется заполнить остальные поля формы: https://chatter.salebot.pro/capusta_callback/result - callback url https://chatter.salebot.pro/capusta_callback/success - success url https://chatter.salebot.pro/capusta_callback/fail - fail ur
Также, помимо этих данных, в системе Capusta Вам потребуется заполнить форму, находящуюся в разделе “Уведомления и переадресация” по ссылке https://dev.capusta.space/#rec167335038

Настройка подключения

Для подключения платежной системы Capusta вам потребуется ввести данные выданного вам токена и кода проекта в настройках в Salebot. В salebot открываем раздел платежные системы, выбираем capusta и вводим полученные данные.

Генерация ссылки на оплату

Для генерации ссылки на оплату Вам необходимо установить значение переменной payment_sum (например, 1000), сразу после этого появится переменная capusta_pay_url. Эту переменную можно вывести на экран ссылкой или разместить на кнопке с текстом "Оплатить". Ссылка имеет вид: https://capu.st/billfb22c773-3a0f
Также, до установки значения переменной payment_sum, можно задать следующие необязательные переменные для настройки платежа:
currency - валюта платежа. Если оставить переменную пустой, платеж автоматически произведется в рублях(‘RUB’). Валюта должна совпадать с валютой, установленной в личном кабинете Capusta.
payment_description – описание платежа.
link_expired - продолжительность жизни платежки. Вы можете ввести дату в формате дд.мм.гггг или дд.мм.гггг чч:мм, например: ‘03.04.2022 19:34’. Внимание! Время формируется по часовому поясу проекта.
payment_comment - Вы можете позволить пользователю, совершающему оплату, оставить свой комментарий к переводу.
test_payments - Вы можете провести тестовый платеж в Capusta, если укажете значение данной переменной равное True. Подробнее о том, какие карты можно указать для тестовых транзакций, Вы можете узнать на странице https://dev.capusta.space/#rec240878484

Пример формирования ссылки на оплату

Создадим ссылку на оплату в размере 10 рублей (внимание - суммы меньше 10 рублей к оплате не проходят!)
Обратите внимание: сначала задаются дополнительные переменные для настроек, затем payment_sum.
Переменные можно задать и ранее в цепочке, а не в одном блоке, это пример.
Далее в нужном месте выводим переменную capusta_pay_url, в которой содержится ссылка

Обработка результата оплаты (callback об оплате)

После успешной оплаты в бот придут callback , по которым вы сможете понять, что была успешная оплата. Эти callback в системе Вы видите как сообщения от пользователя, чтобы их не мог отправить пользователь, они состоят из 10 первых символов токена и приписки success, например: 71b7d77f-7_success
Эти callback НЕ ВИДИТ пользователь, они отображаются только оператору.
Тип сравнения должен быть "Полное совпадение"
Также после успешной оплаты переменная capusta_payment_completed устанавливается в True.
Например, можно сделать обработку успешной оплаты блоком с условием и вывести соответствующее сообщение пользователю:
После завершения оплаты клиенту добавится переменная capusta_callback_data, содержащая данные ответа платежной системы по совершенной операции. Из полученного словаря можно извлечь необходимые данные при помощи метода get.
В случае неудачной оплаты сервис Capusta позволяет пользователю воспользоваться платежной формой еще много раз, вплоть до окончания жизни ссылки. В связи с этим уведомление FAIL в callback не приходит.
Для того, чтобы узнать статус платежки, пытался ли пользователь совершить оплату или же у него не получилось, стоит воспользоваться функцией capusta_check_status().
Ответами функции будут: {'status': '1', 'result': 'Transaction {номер транзакции} is successfully completed'} - получается в случае, когда оплата была успешна проведена 2.{'status': '1', 'result': 'Transaction {номер транзакции} last payment status {статус}'} - в случае, если оплата не удалась. Если сервис сопровождает провал оплаты комментарием, он добавится в переменную capusta_fail_reason(но только, если комментарий был) 3.{'status': '0', 'result': 'Transaction {номер транзакции} is not payed yet'} - клиент еще не совершал платеж по данной транзакции. 4. {'status': '0', 'error': 'No capusta transactions to check'} - получается в случае, если еще не было совершено запроса на платежку.

Создание подписки

В сервисе capusta доступно создание подписок. Для этого стоит присвоить любое значение переменной capusta_subscription_payment, и тогда создастся ежемесячная подписка. Если Вы хотите указать другой период, создайте переменную capusta_subscription_period и присвойте ей одно из следующих значений: ежедневно - "DAILY", еженедельно - "WEEKLY", ежемесячно - "MONTHLY", раз в полгода - "SEMI-ANNUALLY", раз в год - "ANNUALLY", на выбор пользователя -"SELECTIVELY"(в данном случае плательщик сам выбирает периодичность списания средств)
Пример(как выглядит платежка при значении "SELECTIVELY")
После успешного оформления подписки в переменных клиента появится переменная capusta_subscriber_id, обозначающая номер подписчика в системе Capusta.

Отмена подписки

Для того, чтобы отменить существующую подписку, стоит воспользоваться функцией capusta_remove_subscription(capusta_subscriber_id), которая принимает на вход тот самый номер подписчика капусты. После срабатывания функции переменная capusta_subscriber_id очистится и подписка отменится.
Last modified 9mo ago