ЮKassa

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

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

• В Mini App ЮKassa помечена «Юр. лица», а на экране подключения сказано, что нужен магазин ИП, ООО или самозанятого. Условия ЮKassa: для ИП и юрлиц, для самозанятых.
• Покупатель платит в рублях методами, включёнными в вашем магазине. Бот показывает кнопки «Карта», «СБП», «SberPay», «T-Pay», «ЮMoney» и «Alfa Pay», если эти методы есть в магазине.
• Автопродление есть, если ЮKassa разрешила вашему магазину автоплатежи.
• Чеки через ЮKassa Vanderu не отправляет: магазин, в котором включена отправка чеков через ЮKassa, не подключится.

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

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

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

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

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

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

1. В кабинете ЮKassa откройте «Интеграция», затем «Ключи API».
2. Выпустите секретный ключ. У боевого магазина ключ начинается с live_, а при выпуске ЮKassa просит подтвердить его кодом из SMS.
3. Найдите shopId: это номер магазина из цифр. По документации ЮKassa он указан в разделе «Настройки», «Магазин».

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

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

2. Нажмите «ЮKassa». Откроется экран «Подключение ЮKassa» с полями «shopId» и «Секретный ключ». Кнопка «Кабинет ЮKassa» на этом экране открывает кабинет.

3. Скопируйте shopId в кабинете ЮKassa и вставьте его в поле «shopId»: только цифры, не больше 12.

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

   

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

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

При подключении Vanderu проверяет, разрешены ли магазину автоплатежи: создаёт в магазине платёж на 1 ₽ с описанием «Проверка автоплатежей Vanderu — оплачивать не нужно». Его никто не оплачивает, и ЮKassa отменяет его сама. Такой же платёж появляется, когда вы подключаете другой магазин, подключаете ЮKassa после удаления или включаете переключатель «Оплата с автопродлением».

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

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

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

   

2. Нажмите «HTTP-уведомления» в первом шаге блока. Откроется кабинет ЮKassa, раздел «Интеграция», «HTTP-уведомления».

3. Вставьте адрес в поле «URL».

4. Отметьте события payment.succeeded, payment.canceled и refund.succeeded и сохраните настройки.

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

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

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

Если включено автопродление, для тарифов от 3 до 366 дней в боте всегда одна кнопка «ЮKassa (карта, СБП)», какой бы режим вы ни выбрали: режим действует для остальных тарифов. Автопродление включается само при подключении, если ЮKassa разрешила магазину автоплатежи.

Vanderu узнаёт, какие методы включены в магазине, при подключении. Если узнать не удалось, в боте одна кнопка «ЮKassa (карта, СБП)». Если вы включили или выключили метод в кабинете ЮKassa, нажмите «Обновить список способов».

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

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

1. На экране «Детали ЮKassa» найдите блок «Автопродление подписок».

   

2. Если переключатель «Оплата с автопродлением» выключен, включите его. Включить его можно, только пока ЮKassa не отключена.

3. Если в блоке появилось «ЮKassa не разрешает вашему магазину автоплатежи», попросите менеджера ЮKassa подключить их и включите переключатель снова.

Когда переключатель включён:

• Каждая оплата через ЮKassa по тарифу от 3 до 366 дней проходит с автопродлением: ЮKassa сохраняет в вашем магазине то, чем заплатил покупатель, например карту, и Vanderu сам списывает цену тарифа перед окончанием подписки. Если вы измените цену тарифа, спишется новая цена.
• Условия автопродления покупатель видит в сообщении перед оплатой. Если он купил по промокоду, первая оплата идёт со скидкой, а дальше списывается полная цена тарифа.
• Перед каждым списанием бот предупреждает покупателя не позже чем за 3 дня, а перед первым списанием по тарифу на 3 дня не позже чем за 2 дня.
• Списать оплату Vanderu пробует до трёх раз, первый раз примерно за сутки до окончания подписки. Если ни одна попытка не прошла, автопродление выключается, и бот пишет покупателю, что продлить подписку можно вручную.
• Покупатель может отключить автопродление или отвязать карту в боте кнопкой «Мои подписки».
• Под переключателем видно, сколько автопродлений активно и сколько подписок продлено в этом месяце.

Если покупатель заплатил методом, который ЮKassa для автосписаний не сохраняет, подписка оплачена, а бот пишет ему, что автопродление не включилось.

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

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

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

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

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

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

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

Пока уведомления не подтверждены, у карточки «ЮKassa» на экране «Выберите платежную систему» стоит метка «Нужно внимание». Подтвердить их можно платежом на 1 ₽ с возвратом:

1. На экране «Детали ЮKassa» нажмите «Проверить подключение». Появится кнопка «Открыть оплату 1 ₽».
2. Нажмите «Открыть оплату 1 ₽» и оплатите 1 ₽ своей картой на странице оплаты ЮKassa.
3. Вернитесь в Mini App. Пока уведомление не пришло, под кнопкой написано «Ждём уведомление от платёжной системы…». Когда ЮKassa его пришлёт, в блоке «Уведомления об оплате» появится «Уведомления подтверждены» с датой, а метка карточки сменится на «Подключено». Vanderu оформит возврат 1 ₽ в ЮKassa, продажа не запишется.

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

1. Откройте бота своего проекта и нажмите «Тарифы». Если бот попросит «Выбери ресурс», выберите канал. Затем выберите тариф.
2. Нажмите кнопку ЮKassa: «Карта», «СБП» или «ЮKassa (карта, СБП)». Если бот прислал сообщение с кнопкой «Оплатить», ключи подходят.
3. Нажмите «Отменить платеж».

Выдачу доступа проверяет только настоящая оплата из своего бота: деньги поступят в ваш магазин ЮKassa, продажа появится в разделе «Продажи», бот пришлёт дату окончания подписки. Если вы создали этот канал, ссылку на вход бот не пришлёт: для Vanderu вы уже в канале.

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

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

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

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

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

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

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

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

Вы вставили ключ, который начинается с test_. Выпустите ключ боевого магазина: он начинается с live_.

Mini App пишет «В магазине включена отправка чеков через ЮKassa»Скопировать ссылку на раздел

Vanderu не отправляет чеки через ЮKassa, поэтому оплаты такого магазина не пройдут. Выключите отправку чеков через ЮKassa в этом магазине или подключите другой магазин.

Mini App пишет «Магазин требует данные для чека»Скопировать ссылку на раздел

Отправку чеков через ЮKassa включили после подключения, и ЮKassa перестала принимать оплаты. Выключите её в кабинете ЮKassa и на экране «Детали ЮKassa» нажмите «Включить».

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

Ключ не подходит к этому shopId или скопирован не целиком. Проверьте оба значения в кабинете ЮKassa, в разделе «Интеграция», «Ключи API», и вставьте их снова.

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

Адрес для уведомлений не вставлен в кабинет ЮKassa или уведомление не дошло, и оплату нашёл сам Vanderu. Пока уведомления ни разу не подтверждались, @vanderu_bot один раз присылает об этом сообщение: оплата покупателя прошла, но уведомление от ЮKassa не пришло. Вставьте адрес, как описано в разделе «Укажите адрес для уведомлений», и проверьте, что отмечены все три события.

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

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

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

После «Проверить подключение» уведомление не приходитСкопировать ссылку на раздел

Проверьте, что адрес вставлен в кабинете ЮKassa целиком и событие payment.succeeded отмечено. Mini App ждёт уведомление 10 минут. Нажмите «Проверить подключение» ещё раз: если с прошлой проверки прошло меньше 10 минут, откроется тот же платёж.

В блоке автопродления написано «ЮKassa не разрешает вашему магазину автоплатежи»Скопировать ссылку на раздел

Попросите менеджера ЮKassa подключить магазину автоплатежи, затем включите «Оплата с автопродлением» снова. До этого оплаты проходят без сохранения карты.

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

Метод выключен в магазине ЮKassa, или вы не отметили его в режиме «Выбранные», или включено автопродление и у тарифа одна кнопка «ЮKassa (карта, СБП)». Если метод выключен, включите его в кабинете ЮKassa и нажмите «Обновить список способов».

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

ЮKassa отказала в оплате методом, который выключен в магазине, и Vanderu убрал его кнопку. Включите метод в кабинете ЮKassa и нажмите «Обновить список способов».

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

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

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

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

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

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

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

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