YooKassa (Яндекс.касса)
В системе School-Master существует два варианта интеграции с Yookassa:
Yookassa (Яндекс.касса) — старый вариант, резервный.
Yookassa API (Яндекс.касса API) — новый.
Всегда используем новый вариант.
Описание
С Yoo.kassa могут работать организации, ИП и самозанятые.
Способы оплаты
карты VISA, Mastercard, МИР.
Apple Pay, Google Pay.
Интернет-банк: АльфаКлик, Сбербанк-онлайн, Тинькофф. Это означает, что счет приходит пользователю в приложение и он оттуда оплачивает.
Сбербанк Бизнес онлайн.
Наличные. Оплата по коду платежа в терминале, банкомате, кассе банка, в салонах связи и системах денежных переводов — везде, где принимают платежи в пользу ЮKassa или ЮMoney. Только для России и СНГ.
Рассрочка
В Ю.кассе есть интеграция с рассрочкой. Чтобы ее активировать вам нужно написать отдельный запрос в юкассу после регистрации. Тарифы, конечно, конские (20% от суммы платежа с вас при рассрочке, 34% годовых с клиента если кредит), но при желании можно использовать.
Подключение
На сайте https://yookassa.ru/ нажимаем подключить. Отправляем документы и через 1-2 дня можно будет работать.
В Ю.кассу подаётся заявка на подключение и заполняется анкета.
Тут с вами работает персональный менеджер.
Важно! Ваш сайт должен работать по защищённому протоколу https, т.е. должен быть SSL сертификат.
Онлайн-касса
Онлайн-касса подключается к Юкассе. Важно, School-Master не имеет отношения к онлайн-кассе.
Процесс выглядит так
School-Master отправляет данные о сумме, которую нужно списать с клиента в Юкассу.
Юкасса принимает платеж и передает обратно данные об успешной операции.
Вместе с этим, Юкасса передает данные в онлайн-кассу и пользователю и ФНС отправляется чек.
Юкасса позволяет подключить следующие онлайн-кассы
В среднем обслуживание онлайн-кассы выходит 20-30 т.р. в год.
Если онлайн-кассу приобретать не хотите, то можно подключиться к Продамус или Робокассе. Они будут пробивать чеки за вас.
Модуль по протоколу API (рекомендуемый)
Это современный протокол, рекомендуем использовать его, он позволяет работать с онлайн кассами.
При подписании договора укажите что будете использовать протокол API.
Личный кабинет Юкассы
В личном кабинете Ю.Кассы, в разделе «Интеграции», вам нужно создать секретный ключ API и сохранить его.
Там же, в «Интеграциях» — HTTP уведомления нужно указать URL для уведомлений.
https://ваш_сайт/payments/yakassapi/result.php
Настройка внутри School-master
В настройках модуля внутри School Master нужно указать:
используется ли онлайн касса: да/нет
данные вашего ИП или юрлица
School-Master предоставляет 2 способы для вывода оплаты через юкассу.
«Выбор способов на сайте ю.кассы». Ссылка из корзины ведет → на выбор способа оплаты в юкассе → далее пользователь переходит к оплате.
«Выбор способов оплаты на вашем сайте». Мы можем сразу разделить способы оплаты и вывести их в корзине. В этом случае пользователь сразу выбирает удобный вариант оплаты и переходит к оплате.
Старый модуль протокол HTTP
Данные для анкеты:
Тип подключения — HTTP
CheckURL — https://ваш_сайт/payments/yakassa/result.php
AvisoURL — https://ваш_сайт/payments/yakassa/result.php
SuccessURL — https://ваш_сайт/payments/yakassa/success.php
ShoopFailURL — https://ваш_сайт/payments/yakassa/fail.php
Настройка модуля ЮКассы в School-Master
Название, порядок и описание — как у всех.
Shop_ID — ID вашего магазина в Ю.Кассе.
SCID — после подключения менеджер пришлёт вам ваш scid.
Пароль — тот пароль что вы указали в анкете.
Сначала вам дадут возможность попробовать приём оплаты в тестовой среде, для этого вам дадут другие данные (SCID).
Если платёж пройдёт успешно, то ваш магазин переведут в боевой режим и вышлют боевой SCID.
Подключение ЮKassa для приема онлайн-платежей
ЮKassa — это провайдер по приему платежей через интернет.
Способы безналичной онлайн-оплаты с помощью ЮKassa:
- Оплата в форме онлайн-записи. Клиент сможет оплатить услуги в виджете при онлайн-записи. Для включения необходимо выбрать услуги, для которых будет подключена онлайн-оплата. Подробнее о настройке оплаты в форме онлайн-записи читайте здесь. Оплата по QR-коду на кассе. Клиент сможет отсканировать распечатанный QR-код с помощью телефона и оплатить визит. Подробнее можно прочитать здесь.
- Оплата визитов и товаров по ссылке. Администратор сможет отправить клиенту ссылку для оплаты визита любым удобным способом: по SMS, Email, в мессенджер или соцсеть. Подробное описание в статье.
- Онлайн-продажа абонементов и сертификатов. Подробное описание в статье.
Важно
- Онлайн-оплата от ЮKassa не работает через iframe.
В этой статье мы рассмотрим подключение и настройки со стороны ЮKassa. Инструкция по настройке интерфейса YCLIENTS находится здесь.
Доступные методы приема оплат:
- Банковские карты.
- Электронные кошельки.
Условия работы
- Деньги от покупателя поступают на расчетный счет вашей компании на следующий рабочий день после проведения платежа за вычетом комиссии.
- ЮKassa берет комиссию только за успешные платежи.
- Абонентской платы нет.
- Для подключения достаточно скан-копии паспорта владельца компании.
- Подключение клиентов YCLIENTS занимает 1 рабочий день.
- Подключение доступно для самозанятых, в этом случае в филиале должен быть только 1 сотрудник. Важно: для самозанятых недоступно подключение оплаты через СБП по QR-коду.
Для всех клиентов YCLIENTS ЮKassa предоставляет специальные условия со сниженной комиссией*:
- Банковские карты — 2,5 %
- Инвойсинги (От Тинькофф Банка, АльфаБанка и Сбербанка) — 2,5 %
- ЮMoney — 2,5 %
*Специальные условия действуют для новых клиентов ЮKassa.
Подключение
Для подключения к ЮKassa и получения спец. условий оставьте заявку, нажав на кнопку ниже:
1. Перейдите на сайт ЮKassa и нажмите кнопку «Подключить ЮKassa» или «Войти».
2. Нажмите кнопку «Регистрация», если нажали «Войти».
3. Подтвердите номер телефона и следуйте дальнейшим шагам регистрации.
4. Придумайте и подтвердите пароль, затем нажмите «Готово».
5. Укажите имя пользователя и email для работы с ЮKassa, затем нажмите «Далее».
6. Заполните данные юридического лица, ИП или самозанятого, затем нажмите «Готово».
7. После завершения регистрации, в качестве сайта укажите сайт вашей компании, либо ссылку на виджет онлайн-записи YCLIENTS (ссылки на все формы записи находятся в разделе «Онлайн-запись» > «Формы онлайн-записи»).
Если вы уже являетесь клиентом сервиса, но хотите принимать платежи через виджет, понадобится подать заявку на новый магазин через своего менеджера в ЮKassa.
8. В настройках нового магазина вам понадобится зайти в раздел «Интеграция» — «Готовые решения».
Выберите в списке систему YCLIENTS. Начните вводить название и перед вами появится нужный вариант.
9. В личном кабинете необходимо заполнить информацию о компании и загрузить скан-копию паспорта владельца компании. Подробнее про заполнение личного кабинета и предоставление документов доступно на сайте ЮKassa.
10. Для прохождения модерации со стороны платежной системы обязательно заполните контакты и реквизиты компании для отображения на странице информации о филиале в форме онлайн-записи.
Перейдите в раздел «Настройки» > «Мой филиал» > «Информация о филиале».
- Заполните данные на вкладке «Контакты».
- На вкладке «Описание» добавьте реквизиты юридического лица или индивидуального предпринимателя: наименование, ИНН и ОГРН (формат см. на скриншоте):
11. Информация по одобренным документам и подписанию договора будет доступна в личном кабинете ЮKassa.
Важно
- Проверьте настройки интеграции в разделе «Интеграция» — «HTTP-уведомления» в личном кабинете ЮKassa.
В этом разделе должно быть заполнено поле с URL (URL вида https://yclients.com/payments/prepaid/yandexkassa), а также включены все уведомления. Если поле будет пустым или ссылка будет отличаться, в YCLIENTS не будет передаваться статус оплаты, из-за чего оплата не будет отображаться в разделе «Финансы» > «Финансовые операции», и все визиты, оплаченные онлайн, будут удаляться через 15 минут.
Чтобы это исправить, необходимо убрать YCLIENTS в разделе ЮKassa «Интеграция» — «Готовые решения», затем заново выбрать YCLIENTS и сохранить настройки. После поле с URL в разделе «Интеграция» — «HTTP-уведомления» автоматически заполнится.
- Возврат средств клиенту производится через сервис ЮKassa в разделе «Операции» — «Платежи» (подробнее о возвратах читайте в статье по ссылке). Чтобы в YCLIENTS автоматически удалялись финансовые операции после возврата средств клиенту через ЮKassa, необходимо также вручную включить уведомление «refund.succeeded». Это уведомление не включается автоматически при настройке интеграции. Чтобы его включить, в разделе «Интеграция» —«HTTP-уведомления» нажмите на кнопку «Задать вручную», затем переключите ползунок «refund.succeeded» и сохраните настройки.
- Чтобы изменить название вашегомагазина, необходимо написать в техническуюподдержку ЮKassa с просьбой сменить банковский дескриптор (указывается латиницей, до 14 знаков).
Печать чеков
ЮKassa также предоставляет возможность отправки фискализированных чеков покупателям, согласно закону 54-ФЗ (Федеральный закон “О ККТ”).
Для подключения онлайн-кассы необходимо:
1. Купить или арендовать онлайн-кассу (ККТ — контрольно-кассовая техника) по ссылке.
2. Заключить договор с оператором фискальных данных (ОФД) — подойдет любой. Список операторов фискальных данных по ссылке.
3. Получить квалифицированную электронную подпись (КЭП, нужна для регистрации онлайн-кассы в налоговой).
4. Зарегистрировать онлайн-кассу в налоговой. Сделать это можно через личный кабинет юридического лица или ИП на сайте nalog.ru
В данный момент YCLIENTS не поддерживает автоматический обмен с ЮKassa для онлайн-фискализации, поэтому в настройках ЮKassa можно не выбирать провайдера (вы сможете пробивать чеки вручную).
Как это работает?
Если подключена онлайн-касса в YCLIENTS:
- При онлайн-оплате услуг или лояльности (онлайн-продаже абонементов/сертификатов) клиент в виджете онлайн-записи/продажи производит оплату, то есть совершается перевод денежных средств с карты клиента на счет филиала/компании. В этом случае клиент получает на Email выписку по проведению оплаты — это нефискальный чек.
- В филиале в визите/продаже товара передается информация об оплате, создается финансовая операция на специально выделенную кассу, фискальный чек при этом автоматически не печатается.
- Чек в этом случае необходимо печатать вручную, нажав на кнопку «Распечатать чек продажи» в визите или операции продажи.
Если подключена облачная касса от ЮKassa:
- У ЮKassa есть отдельный сервис облачной кассы. Такая касса имеет фискальный накопитель и может передавать данные в налоговую, то есть производит фискальные чеки.
- В этом случае клиент проводит оплату через виджет онлайн-записи/продажи и получает на Email выписку по проведению оплаты — это нефискальный чек.
- Далее по этой оплате производится фискализация чекачерез облачную кассу. Клиенту фискальный чек придет на Email или по SMS.
- В систему YCLIENTS передается только статус оплаты, информация, что фискальный чек по этой оплате был распечатан, не передается.
- Важно: в филиале при такой интеграции печатать чек вручную не нужно. В этом случае, если распечатать чек по визиту/продаже, которые оплатили онлайн, произойдет задвоение оплат, что скажется на бухгалтерских отчетах.
Подробнее о фискализации онлайн-платежей читайте в статье.
Автоотправка чеков для самозанятых
По закону 422-ФЗ при получении платежей за проданные товары и оказанные услуги самозанятому необходимо зарегистрировать доход в сервисе «Мой налог». При регистрации сервис сформирует чек прихода, который нужно передать покупателю. Если вы отменяете или возвращаете платеж, зарегистрированный чек нужно аннулировать (сторнировать, отменить), чтобы налоговая не учитывала эти данные.
Чтобы не делать это вручную, вы можете использовать решение ЮKassa для автоотправки чеков. С его помощью вы можете автоматически регистрировать и аннулировать чеки в сервисе «Мой налог» при каждом платеже или возврате. Подробнее о функционале и настройке читайте здесь.
Оставьте заявку на консультацию — мы поможем с настройкой.
Подключение ЮKassa
ЮKassa — сервис, который позволяет включить прием платежей на сайте и получать деньги на расчётный счёт компании. Комиссия берётся с успешных платежей.
Магазин в ЮKassa может зарегистрировать только индивидуальный предприниматель или юридическое лицо. Если вы являетесь физическим лицом, то можете воспользоваться другими вариантами приема платежей: WayForPay , Яндекс.Деньги .
Обязательное требование для регистрации магазина в ЮKassa — наличие сайта, который уже доступен в интернете по реальному доменному имени.
Если у вас уже есть зарегистрированный магазин в ЮKassa то он не подойдет, так как нужно регистрировать магазин с другими параметрами. Оформить другой магазин с адресом сайта, на который уже зарегистрирован магазин согласно политики ЮKassa нельзя. Поэтому нужно будет либо оформлять магазин на другой сайт, либо на этот же сайт, но с поддоменом, например test.leeloo.ai, где "test" — это поддомен.
Как подключить ЮKassa?
Регистрация в ЮKassa
-
в ЮKassa.
- Заполните данные для договора и загрузите копии документов (всё в личном кабинете).
- Подпишите договор с ЮMoney (можно электронной подписью).
- Настройте интеграцию, если она нужна.
- Протестируйте прием платежей в тестовом магазине, если нужно.
Данные для договора
Сразу после регистрации нужно указать данные для договора и выбрать готовое решение в меню Интеграция.
Выбор готового решения
- Зайдите в раздел Интеграция — Готовые решения.
3. Выберите в списке “ Leeloo.ai ” или начните вводить название, чтобы воспользоваться поиском.
- Выберите модуль Leeloo.ai
- Сохраните изменения
Проверка анкеты и подписание договора
Когда проверка пройдена, в личном кабинете появится страница подписания договора.
- Скачайте договор (заявление о подключении) и распечатайте его.
- На последней странице поставьте дату, подпись и печать (если она у вас есть). На всех остальных — подпись с расшифровкой.
- От сканируйте все страницы договора и отправьте сканы Яндекс Кассе на подпись.
Когда Ю.Касса подпишет договор (это занимает от 1 до 3 рабочих дней), его можно будет скачать в личном кабинете. Если к этому времени вы уже выбрали готовое решение — можно перейти к настройкам модуля и принимать платежи.
Параметры для настройки модуля
— shopId — появится в личном кабинете Кассы сам, когда вы подключитесь к сервису,
— секретный ключ (shop secret key) — нужно самостоятельно выпустить после подписания договора и активировать в личном кабинете Кассы по инструкции . До подписания договора можно использовать секретный ключ из тестового магазина .
2. Подключение опций оплаты в один клик и автоплатежей
После успешной регистрации магазина нужно подключить опции оплаты в "один клик" (привязка карты к магазину) и автоплатежей. Эти опции необходимы для приема оплат через нашу платформу. Стоит понимать, что это доп.опции и подключаются по отдельному согласованию.
2.1. Отправьте из личного кабинета Ю.Кассы запрос на подключение опций автоплатежей и оплаты в "один клик" .
2.2. Вас спросят, как покупатель сможет отвязать банковскую карту и попросят указать планируемые обороты в месяц по онлайн платежам. Данная информация необходима для проведения согласования.
2.3. В ответном письме сообщите:
Так как общение с людьми и оплаты товара происходят посредством мессенджера, то функция отвязки карты реализована также через мессенджер. Клиент сообщает, что хочет отвязать карту, или спрашивает, как отвязать карту, и бот дает ему инструкцию, как это сделать. Клиент отправляет боту команду /my_info — и затем открывается страница с его данными, где он может отвязать карту.
Пример:
Также в ответном письме укажите планируемые обороты в месяц по онлайн-платежам.
Если поддержка Яндекс.Кассы спрашивает, как быстро по факту отвязывается сама карта, после обращения пользователя к боту?, то ответьте:
Карта отвязывается немедленно после получения ботом команды.
2.4. В случае положительного результата согласования, вам отправят файл дополнительного соглашения, сканы которого, заверенные печатью организации и подписью руководителя, вам необходимо будет отправить Ю.Кассе во вложении к ответному письму.
Если поддержка Яндекс.Кассы просит:
- заполнить и прислать заявку в соответствии с инструкцией по обмену сертификатами (во вложении).
- прислать файл запроса на сертификат (в формате csr) и список ip адресов, с которых будет уходить запрос.
- реализовать данную опцию: https://kassa.yandex.ru/docs/checkout-api/#ispol-zowanie-api
— ответьте, что техническая часть уже реализована на стороне сервиса через API, поэтому подтверждение сертификации не требуется.
3. Подключение магазина к платформе
3.1. После успешного подключения функции оплаты в один клик, Вам выдадут ShopID. По инструкции получите Shop Secret Key.
3.2. Перейдите на платформе в пункт меню Настройки — Интеграции — Платежные системы. Нажмите на кнопку "+ Новая платежная система" для добавления нового аккаунта в систему.
Выбираем "Яндекс Касса":
3.3. В открывшейся форме в первое поле введите имя аккаунта (произвольное). Оно будет служить идентификатором при прикреплении аккаунта платежной системы к офферу.
Описание полей мерчанта:
1.Название (имя) мерчанта;
3. ShopID — После успешного подключения функции оплаты в один клик, вам выдадут ShopID;
4. Shop Secret Key — секретный ключ, который Вы получаете согласно инструкции;
Дополнительные настройки:
5. Комиссия Яндекс Кассы за перевод (по умолчанию установлена 3,5%);
6.Плата за перевод;
7. Валюта транзакции;
8. Валюта начисления;
9. Формирование чека в онлайн-кассе — данная опция отвечает за онлайн-кассу. В случае подключения онлайн-кассы, включите данную опцию;
10. Ставка НДС (по умолчанию — Без НДС);
11. Система налогообложения (по умолчанию установлена общая система налогообложения);
12. Несколько систем налогообложения — устанавливается, если в компании несколько систем уплаты налогов;
14. К списку платежных систем.
Примечания:
1) Во третье поле вставьте ShopID приложения Яндекс Касса.
2) Вставьте Shop Secret Key в четвертое поле в форме добавления аккаунта на платформе.
3)Нажмите кнопку Сохранить.
Добавилась информация о чеках. Она находится в настройках интеграции.
Благодаря данным изменениям, при оформлении платежа, можно будет видеть автоматически сформированные чеки, которые будут отправляться платежной системой в налоговую.
Если при попытке оплаты предложения случается ошибка "Неуспешный платеж"
Ошибка свидетельствует о том, что не подключены опции оплаты в один клик и рекурентные платежи. По сообщениям клиентов, которым уже удалось подключить Яндекс.Кассу к платформе, иногда опции однокликовых платежей и рекуррентные платежи, после заключения договора о их подключении, остаются не подключенными. Обратитесь к вашему техническому специалисту Яндекс.Кассы (не менеджеру!), чтобы он подтвердил, что опции оплаты в один клик и рекуррентные платежи подключены. Его контакт вы можете найти, нажав на кнопку Поддержка в личном кабинете Яндекс.Кассы.
Если подключена онлайн-касса
Если у Вас подключена онлайн-касса, то для успешного проведения платежа через платформу нужно в настройках мерчанта включить опцию "Формирование чека в онлайн-кассе".
Подключение онлайн-курс необходимо для передачи чеков в налоговую инспекцию исходя из законодательства РФ.
1.Регистрация на сервисе и заполнение анкеты
Шаг 3. После регистрации заполняем данные договора.
Сначала укажем адрес сайта, например:
Важно! ИспользуйтеSSL-сертификат, чтобы обеспечить безопасную электронную коммерцию на своем сайте посредством подключения через HTTPS (настройка обязательна для подключения оплаты).
Если ваш домен на кириллице, его необходимо указывать в punycode.
Пример:
Преобразовать домен в puonycode можно через «Punycode конвертер». Или открыть страницу в браузере и скопировать адрес из адресной строки.
Нажмем кнопку «Сохранить и продолжить».
Шаг 4. Заполняем формы из следующих разделов: «Реквизиты», «Данные руководителя», «Юридические вопросы». После того как все пункты будут отмечены зеленой галочкой, отправляем анкету на проверку.
Узнать больше о заполнении данных можно в инструкции Яндекс.
Шаг 5. Когда вашу анкету проверят и одобрят, нужно будет скачать, подписать договор и загрузить его скан в кабинете Яндекс, на странице подписания договора (она появится позже). Также отправить оригинал договора по почте или через электронный документооборот.
О подписании договора больше информации можно найти в статье от Яндекс.
После проверки документов будет создан кабинет магазина со стороны Яндекс.Кассы, в котором можно будет найти все необходимые данные для интеграции.
2. Создание интеграции в личном кабинете Платформы LP
Шаг 1. Переходим в личный кабинет Платформы LP, выбираем желаемый проект — раздел «Интеграции».
Шаг 2. Нажимаем «Добавить интеграцию» и выбираем «Яндекс.Кассу».
Шаг 3. Теперь введём данные из кабинета Яндекс.Кассы в соответствующие поля интеграции на Платформе.
«Название» — укажем любое название интеграции для удобства;
«Идентификатор магазина» — идентификатор магазина shopid можно найти в левом верхнем углу кабинета Яндекс, либо в разделе «Настройки» — «Магазин»;
«Пароль» — вводим секретный ключ API из настроек Я.Кассы. Найти его можно в разделе «Интеграция» — «Ключи API»
Важно! В разделе «HTTP уведомления» необходимо заполнить поле «URL для уведомлений», указав ссылку:
А также включить первый ползунок «Payment Successed» для получения оплаченного статуса заявки.
«Адрес для возврата после оплаты» — вводим адрес страницы для перенаправления посетителя после этапа оплаты. Можно указать ссылку на главную страницу сайта или страницу благодарности, например:
Важно! По этому адресу покупателя будет перенаправлять вне зависимости от результата оплаты.
Шаг 4. Когда все поля новой интеграции заполнены, нажимаем «Добавить».
Если все данные указаны верно, откроется страница с настройками интеграции, где можно включить и настроить передачу данных для чека. Выбираем нужные настройки и сохраняем изменения.
С июля 2017 года предприниматели обязуются вместо обычных кассовых аппаратов установить онлайн-кассы, которые передают информацию о каждой покупке напрямую в налоговые органы.
Подробнее об онлайн-кассах
В кабинете Яндекс онлайн-кассу можно активировать в настройках:
3.Подключаем интеграцию к странице
Шаг 1. Переходим в настройки страницы.
Шаг 2. Переходим во вкладку «Настройка магазина» и выбираем только что созданную интеграцию с Яндекс.Кассой.
Шаг 3. Переходим в редактор страницы.
Шаг 4. Заходим в настройки корзины. Открываем форму и переходим в настройки формы, где указываем в списке «Действие после отправки» «Переход к оплате».
После всех изменений опубликуйте повторно страницу.
Вы только что настроили интеграцию с сервисом Яндекс.Касса.
Приятной работы!
Если на вашей странице есть товар и под ним кнопка «Заказать», но нет корзины, в которую можно добавить сразу несколько товаров, мы рекомендуем использовать в карточке товара Кнопку с формой:
и в настройках формы выбрать "Переход к оплате".
. В карточку товара нельзя вставить кнопку с модальным окном и новой формой в нем. В таком случае необходимо в модальном окне создать карточку товара, чтобы новая форма находилась с ней в одном виджете (окне):
Важно: после включения перехода к оплате указываем параметры товара – название и цену в настройках формы и в виджетах «Название товара / Цена товара» (цену можно указать только в валюте RUB).
4.Как будут выглядеть оплаченные заявки?
Уведомление об оплаченной заявке можно увидеть в разделе «Заявки».
Также оно придёт на почту, которая указана в настройках Яндекс.Кассы.