FreeKassa

Покупатель выбирает тариф в боте проекта и платит картой или по СБП на форме оплаты FreeKassa (Фрикасса), а деньги приходят на баланс вашего магазина во FreeKassa. Оплату подтверждает уведомление FreeKassa, подписанное вашим секретным словом, после него бот проекта отправляет покупателю ссылку на вход в канал или группу.

Кому подходитСкопировать ссылку на раздел

• В Mini App FreeKassa помечена «Юр. лица». На сайте FreeKassa сказано, что FreeKassa работает с физическими и юридическими лицами. Нужен свой магазин во FreeKassa, прошедший проверку.
• Покупатель платит в рублях, картой или по СБП.
• Автопродления нет: за каждый срок подписки покупатель платит сам.

Сравнить с другими способами: сравнительная таблица платёжных систем.

Что нужно заранееСкопировать ссылку на раздел

Для шагов ниже:

• Проект в Vanderu: как создать проект. Пока проекта нет, на главном экране Mini App нет раздела «Настройки».
• Магазин во FreeKassa, прошедший проверку, и доступ к личному кабинету FreeKassa.
• Запущенный @vanderu_bot: в нём приходят сообщения о продажах и о сбоях способа оплаты. Если вы ещё не писали ему, откройте с ним чат и отправьте /start.

Чтобы покупатель увидел способ в боте: канал или группа (канал, группа) и платный тариф проекта (как создать тариф).

Возьмите ключи в кабинете FreeKassaСкопировать ссылку на раздел

ID магазина, API-ключ и оба секретных слова есть на странице настроек магазина в личном кабинете FreeKassa.

1. Откройте настройки магазина и выключите «Тестовый режим», если он включён.
2. Найдите ID магазина и API-ключ.
3. Найдите «Секретное слово» и «Секретное слово 2». Это два разных поля: первое нужно для формы оплаты, второе — для уведомлений об оплате.

Подключите FreeKassa в Mini AppСкопировать ссылку на раздел

1. Откройте Mini App из чата с @vanderu_bot и прокрутите главный экран вниз. В разделе «Настройки» нажмите «Платежные системы». Откроется экран «Выберите платежную систему».

2. Нажмите «FreeKassa». Откроется экран «Подключение FreeKassa» с полями «ID магазина», «API-ключ», «Секретное слово» и «Секретное слово 2». Кнопка «Настройки магазина» на этом экране открывает кабинет FreeKassa.

3. Скопируйте ID магазина в кабинете FreeKassa и вставьте его в поле «ID магазина»: только цифры.

4. Скопируйте API-ключ и вставьте его в поле «API-ключ» целиком.

   Секретные слова Vanderu при сохранении проверить не может. Ошибка в «Секретное слово» не даст покупателям оплатить: FreeKassa отклонит форму оплаты. Ошибка в «Секретное слово 2» задержит выдачу доступа.

5. Скопируйте «Секретное слово» и вставьте его в поле «Секретное слово».

6. Скопируйте «Секретное слово 2» и вставьте его в поле «Секретное слово 2».

   

7. Нажмите «Сохранить» внизу экрана. Vanderu проверит ID магазина и API-ключ у FreeKassa. Mini App покажет «Ключи проверены, способ оплаты подключён» и откроет экран «Детали FreeKassa» со статусом «Принимает оплату».

FreeKassa сразу появляется у покупателей во всех ваших проектах, в том числе в новых. Чтобы оставить её только в некоторых проектах, на экране «Детали FreeKassa» нажмите «Проекты».

Укажите адрес для уведомленийСкопировать ссылку на раздел

Пока адрес не вставлен, FreeKassa не сообщает Vanderu об оплате, и Vanderu проверяет её сам: первые 30 минут после того, как покупатель выбрал метод в боте, раз в 2 минуты, до 3 часов раз в 15 минут, затем раз в час. Через сутки Vanderu перестаёт проверять оплату, а после «Отменить платеж» не проверяет вовсе: такую оплату засчитает только уведомление.

1. На экране «Детали FreeKassa», в блоке «Уведомления об оплате», нажмите на адрес под первым шагом. Mini App покажет «Ссылка скопирована». Открывать адрес не нужно.

   

2. В настройках магазина FreeKassa вставьте адрес в поле «URL оповещения».

3. В поле «Метод оповещения» выберите POST и сохраните настройки. С методом GET уведомления не пройдут.

4. Если хотите, чтобы FreeKassa повторяла уведомление, пока Vanderu его не примет, попросите поддержку FreeKassa включить «Подтверждение платежа». Без этого пропущенную оплату Vanderu найдёт сам, но позже.

Выберите кнопки оплаты в ботеСкопировать ссылку на раздел

На экране «Детали FreeKassa», в блоке «Кнопки оплаты в боте», выберите режим и нажмите «Сохранить». Mini App покажет «Кнопки оплаты сохранены».

• «Все»: кнопки «Карта» и «СБП» для методов, включённых в магазине.
• «Выбранные»: кнопки только для методов, которые вы отметите.
• «Одна кнопка»: в боте одна кнопка «FreeKassa (СБП, карта)», метод покупатель выбирает на форме оплаты FreeKassa. В подсказке под режимом Mini App пишет «карта, СБП», в боте порядок обратный.

Если вы включили или выключили метод в кабинете FreeKassa, нажмите «Обновить список способов».

На кнопках методов нет названия FreeKassa. Если у вас подключён ещё один способ оплаты с кнопками «Карта» и «СБП», покупатель увидит эти кнопки дважды. Чтобы этого не было, у одного из способов выберите «Одна кнопка».

Как покупатель платитСкопировать ссылку на раздел

1. Покупатель открывает бота проекта, нажимает «Тарифы» и выбирает тариф.
2. Бот пишет «Выберите способ оплаты» и показывает кнопки, выбранные в блоке «Кнопки оплаты в боте».
3. Покупатель нажимает кнопку. Бот присылает сообщение «Вы выбрали» с методом, суммой, каналом, тарифом и сроком и кнопки «Оплатить» и «Отменить платеж». С промокодом сумма равна цене со скидкой.
4. «Оплатить» открывает форму оплаты FreeKassa. Кнопка в боте только предлагает метод: на форме покупатель может выбрать другой.
5. Куда форма отправит покупателя после оплаты, задаёт поле «URL возврата в случае успеха» в настройках магазина FreeKassa: Vanderu его не передаёт.
6. Когда оплата прошла и Vanderu узнал о ней, бот проекта присылает покупателю дату окончания подписки и, если покупателя ещё нет в канале, ссылку на вход. Ссылка одноразовая и действует до конца подписки. Если тариф открывает доступ к нескольким каналам, бот пришлёт по ссылке на каждый канал, где покупателя нет.
7. Оплата появляется в разделе «Продажи» со способом «FreeKassa», а @vanderu_bot присылает вам сообщение о новой продаже.

«Отменить платеж» возвращает покупателя к выбору способа оплаты, но оплату у FreeKassa не отменяет. Если покупатель всё же заплатит на уже открытой форме оплаты, Vanderu засчитает оплату только по уведомлению FreeKassa, поэтому адрес для уведомлений должен быть вставлен.

Текст сообщения со ссылкой меняется в Mini App: на экране проекта нажмите «Сообщения бота», затем «После покупки». Ссылка стоит в тексте там, где написано {link}, а дата окончания подписки — там, где {date}. Если убрать их из текста, покупатель не получит ссылку или дату.

Как проверитьСкопировать ссылку на раздел

Проверочного платежа у FreeKassa в Vanderu нет. Пока FreeKassa не прислала ни одного уведомления, у карточки «FreeKassa» на экране «Выберите платежную систему» стоит метка «Нужно внимание».

Проверьте со стороны покупателя, не платя:

1. Откройте бота своего проекта и нажмите «Тарифы». Если бот попросит «Выбери ресурс», выберите канал. Затем выберите тариф.
2. Нажмите «Карта», «СБП» или «FreeKassa (СБП, карта)». Бот пришлёт сообщение с кнопкой «Оплатить». Это сообщение ключей не проверяет: ссылку на форму оплаты Vanderu собирает сам, без запроса к FreeKassa. ID магазина и API-ключ Vanderu проверил, когда вы нажали «Сохранить».
3. Нажмите «Оплатить». Должна открыться форма оплаты FreeKassa без ошибки: так проверяется «Секретное слово». Закройте форму. «Секретное слово 2» проверит только первое уведомление об оплате.
4. В боте нажмите «Отменить платеж».

Чтобы подтвердить уведомления, оплатите тариф из своего бота: деньги поступят на баланс магазина FreeKassa, продажа появится в разделе «Продажи», бот пришлёт дату окончания подписки. Затем на экране «Детали FreeKassa» нажмите «Обновить статус»: в блоке «Уведомления об оплате» появится «Уведомления подтверждены» с датой, а метка карточки сменится на «Подключено». Уведомления подтвердит и любая другая оплата в этом магазине, даже не из Vanderu. Если вы создали этот канал, ссылку на вход бот не пришлёт: для Vanderu вы уже в канале.

Изменить, отключить или удалить FreeKassaСкопировать ссылку на раздел

На главном экране Mini App в разделе «Настройки» нажмите «Платежные системы», затем «FreeKassa». Откроется экран «Детали FreeKassa».

Чтобы оставить FreeKassa только в некоторых проектах, нажмите «Проекты», выключите лишние проекты и нажмите «Сохранить».

Чтобы заменить ключи, нажмите «Изменить ключи». Откроется форма «Новые ключи FreeKassa». Сохранённые ключи Mini App не показывает: заполните все четыре поля заново и нажмите «Сохранить». Если это другой магазин, уведомления нужно подтвердить заново, а кнопки оплаты вернутся к режиму «Все». Если FreeKassa отключена, новые ключи её не включат: нажмите «Включить».

Чтобы скрыть FreeKassa от покупателей во всех проектах, нажмите «Отключить» и подтвердите. Оплаты, начатые до отключения, засчитаются, а ключи и настройки сохранятся. Вернуть способ можно кнопкой «Включить»: Vanderu снова проверит ключи у FreeKassa.

Чтобы удалить FreeKassa, нажмите «Удалить», а затем в течение 5 секунд ещё раз, когда кнопка покажет «Нажмите ещё раз, чтобы удалить». Vanderu сотрёт ключи, продажи в разделе «Продажи» останутся. Если подключить FreeKassa снова, адрес для уведомлений будет прежним, но уведомления нужно будет подтвердить заново, а кнопки оплаты вернутся к режиму «Все».

Если не получилосьСкопировать ссылку на раздел

Mini App пишет «Неверный ID магазина или API-ключ»Скопировать ссылку на раздел

Проверьте оба значения в настройках магазина в личном кабинете FreeKassa и вставьте их снова.

Под полем написано «Без пробелов» или «ID магазина — только цифры»Скопировать ссылку на раздел

В значение попал пробел или лишний символ. Скопируйте значение из настроек магазина заново: ID магазина состоит только из цифр, API-ключ и секретные слова пишутся без пробелов.

Покупатель нажимает «Оплатить», а форма FreeKassa показывает ошибкуСкопировать ссылку на раздел

Скорее всего, в Mini App сохранено не то «Секретное слово». Нажмите «Изменить ключи» и заполните все четыре поля заново, «Секретное слово» и «Секретное слово 2» каждое в своё поле.

Покупатель оплатил, а доступ пришёл с задержкойСкопировать ссылку на раздел

Уведомление не пришло или не прошло проверку, и оплату нашёл сам Vanderu. Пока уведомления ни разу не подтверждались, @vanderu_bot один раз присылает об этом сообщение с просьбой проверить настройки магазина. Проверьте в настройках магазина FreeKassa, что в поле «URL оповещения» стоит адрес из Mini App, в поле «Метод оповещения» выбран POST, а «Секретное слово 2» то же, что вы сохранили в Mini App.

Покупатель оплатил, а доступа нетСкопировать ссылку на раздел

Без уведомления Vanderu не засчитает оплату, сделанную позже чем через сутки после выбора метода, и оплату после «Отменить платеж». Уведомление не приходит, если адрес не вставлен, и не проходит, если в поле «Метод оповещения» выбран GET или «Секретное слово 2» в Mini App не совпадает с кабинетом.

1. Исправьте причину: в настройках магазина FreeKassa проверьте, что в поле «URL оповещения» стоит адрес из Mini App, а в поле «Метод оповещения» выбран POST. Если не совпадает «Секретное слово 2», нажмите «Изменить ключи» и заполните все четыре поля заново.
2. Найдите оплату в кабинете FreeKassa.
3. Проверьте, не появилась ли оплата в разделе «Продажи». Если поддержка FreeKassa включила вам «Подтверждение платежа», FreeKassa повторяет уведомление, пока Vanderu его не примет, и после исправления повтор может засчитать оплату.
4. Если продажи нет, а оплата в кабинете прошла, выдайте доступ вручную: на экране проекта нажмите «Добавить подписчика», выберите тариф и нажмите «Добавить подписку». Mini App покажет ссылку, перешлите её покупателю. Если уведомление по этой оплате потом всё же пройдёт, покупатель получит ещё один срок подписки, а вам придёт «Новая продажа».

@vanderu_bot пишет, что ключи больше не подходятСкопировать ссылку на раздел

Сообщение говорит, что ключи FreeKassa больше не подходят, или что перестал работать способ оплаты «FreeKassa» с причиной «ключи магазина больше не подходят». FreeKassa больше не принимает сохранённый API-ключ. Пока ключи не обновлены, оплатить через FreeKassa нельзя: бот её не показывает или на нажатие отвечает, что оплата этим способом сейчас не работает. Нажмите «Изменить ключи» и заполните все четыре поля заново.

Покупатель пишет, что при создании ссылки произошла ошибкаСкопировать ссылку на раздел

Оплата прошла, подписка записана, но @vanderu_bot не смог создать ссылку на вход, например потому, что у него нет прав администратора в канале. Верните ему права, чтобы это не повторилось: для канала, для группы. Этому покупателю бот ссылку повторно не пришлёт: напишите в поддержку @vanderusupport_bot и укажите дату и сумму оплаты из раздела «Продажи».

Если не помоглоСкопировать ссылку на раздел

Напишите в поддержку: @vanderusupport_bot.

ОграниченияСкопировать ссылку на раздел

• Оплата только в рублях, картой или по СБП.
• Тестовой оплаты FreeKassa в Vanderu нет: «Тестовый режим» магазина должен быть выключен.
• Без адреса для уведомлений Vanderu проверяет оплату сам только сутки после выбора метода и не проверяет оплату после «Отменить платеж».
• О возвратах FreeKassa Vanderu не узнаёт: если вы вернёте оплату, доступ покупателя останется.
• Если тариф проекта бесплатный, способов оплаты у него нет: покупатель получает доступ кнопкой «Получить». Пробный тариф проекта (от 3 до 30 дней по цене ниже тарифа продления, затем автопродление) оплачивается только через ЮKassa с автопродлением, FreeKassa у него не показывается.
• Комиссию за приём оплат берёт FreeKassa: комиссии FreeKassa на сайте FreeKassa.
• Сколько вы платите Vanderu: тарифы Vanderu.