¶ Общая схема взаимодействия
¶ Пять шагов подключения биллинга
- Зарегистрировать личный кабинет в сервисе "Ю-Касса" - https://yookassa.ru/
- Создать магазин в личном кабинете "Ю-Касса"
- Подключить "Ю-Кассу" в личном кабинете Росдомофона используя Api-Key и Shop-ID. Раздел меню "Счета и платежи"
- В личном кабинете выставить дату создания счета, дату уведомления о счете и дату блокировки при неоплате абонентом. Раздел меню "Счета и платежи"
- В личном кабинете, для каждой услуги, которую вы планируете тарифицировать, необходимо настроить тарифы для абонентов. Тарификация абонентов возможна как целиком по-услуге ,так и индивидуально по-квартирно.
¶ Данные для регистрации в сервисе “Ю-Касса”
В качестве платежной системы мы предлагаем использовать сервис "Ю-Касса" https://yookassa.ru. Вам необходимо зарегистрироваться в платежной системе и внести данные Api-Key и Shop-ID в личный кабинет РосДомофона, в разделе "Счета и Платежи".
При регистрации компании в ЛК Ю-Кассы необходимо использовать то же самое юр.лицо, которое зарегистрировано в ЛК Росдомофона. При оплате счета абоненты должны совершать оплату тому юр.лицу, которое прописано в договоре на оказание услуг.
¶ Для регистрации магазина в ЛК Ю-Кассы необходимо:
- Выбрать вкладку - "Магазин"
- Выбрать вкладку - "Без сайта"
- Установить галочку - "В своем приложении"
- Назвать услугу за которую вы будете принимать платежи - "Услуги умной домофонии"
- Указать ссылку на приложение в AppStore - https://apps.apple.com/ru/app/id1422470505
Для регистрации магазина в Ю-кассе, как правило, для примера, достаточно использовать одну ссылку на приложение для iOS. Работа платежного сервиса на остальных платформах от этого не пострадает.
-
Приложить скриншот из мобильного приложения с ценами на услуги - Скачать файл
-
Приложить скриншот из мобильного приложения с пользовательским соглашением - Скачать файл
При необходимости, сохраните скриншоты на локальный компьютер для последующей отправки файлов в форму регистрации магазина
Для регистрации магазина в ЛК Ю-Кассы сотрудники Ю-Кассы могут дополнительно запросить следующие данные:
¶ Данные для входа в приложение "РосДомофон"для ознакомления
Номер телефона: 79000000000
Пароль для входа: 5555
¶ Ссылки для скачивания приложения для всех мобильных платформ
- Приложение для iOS на платформе AppStore - https://apps.apple.com/app/id1422470505
- Приложение для Android на платформе Google Play - https://play.google.com/store/apps/details?id=com.rosdomofon.rdua&hl=ru&gl=US
- Приложение для Huawei на платформе AppGallery - https://appgallery.huawei.com/app/C103925489
¶ Ссылка на пользовательское соглашение
¶ Активация "Ключей API" Ю-Кассы
- В ЛК Ю-Кассы перейти в раздел "Интеграция" - "Ключи API"
- Создать "Секретный ключ". Данный ключ используется для отправки запросов на создание счетов в мобильном приложении. Ключ необходимо вставить в ЛК РосДомофон, в разделе "Счета и Платежи".
¶ Инструкция по подключению онлайн-кассы к сервису "Ю-Касса"
С помощью Ю-Кассы Вы сможете привязать электронные чеки к Вашей онлайн-кассе, для выдачи электронного чека абоненту через мобильное устройство (после совершения оплаты) и для последующей автоматической передачи отчетности в налоговую инспекцию. Это очень удобно и позволит Вам в будущем сэкономить массу времени.
Ссылка на инструкцию "Настройка онлайн-кассы"
¶ Отправка чеков через "Ю-Кассу" без аренды онлайн-кассы
Чеки от Ю-Кассы. Вы не платите за свою онлайн-кассу и фискальный накопитель, не нужна регистрация в налоговой, не требуется подключение и настройка кассы. ЮKassa автоматически передаёт информацию о платежах в онлайн‑кассу партнёра, она формирует чеки и отправляет через ОФД в налоговую и покупателям. Всё в соответствии с 54‑ФЗ.
Ссылка на инструкцию "Настройка фискализации чеков"
¶ Как подключить сервис РосДомофон к биллингу
Данный функционал доступен для пользователей с ролью “Менеджер по работе со счетами”
-
Зайдите в раздел “Счета и платежи”.
-
Выберите ЮKassa
-
Посмотрите внимательно инструкцию по регистрации в Ю-Кассе и сделайте шаги, уĸазанные под видео. Когда все шаги будут пройдены, завершите первоначальную настройĸу нажатием ĸнопĸи «Готово». Осталось дождаться, ĸогда договор проверят сотрудниĸи ЮKassы и начать интеграцию.
-
При подтверждении договора вам станет доступна панель администрирования в ЮKassa. В ней вы найдите API-ĸлюч и ID магазина для заполнения формы во вĸладĸе «Интеграция». Таĸже на этой вĸладĸе необходимо настроить задачи по расписанию:
- День месяца выставления счетов. В этот день будет создаваться счет в приложении.
- День месяца уведомления о счете. В этот день появится баннер на домашнем экране приложения, и придет пуш-уведомление с просьбой оплатить счет.
- День месяца блокировки. В этот день произойдет блокировка функционала приложения, и придет пуш-уведомление о блокировке.всех абонентов
Если вы работате по системе предоплаты, проверьте, что число блокировки установлено меньше, чем число выставления счета: абонент видит в приложении только последний выставленный счет, и не должен получить новый раньше, чем произойдет блокировка.
Если новый счет будет выставлен раньше блокировки, то оплативший его абонент все равно будет заблокирован за неуплату предыдущего.
- Плюс, признак "счета выставлять за текущий или за следующий месяц".
Если вы выбрали модель Предоплата, удостоверьтесь, что число блокировки установлено меньше, чем число выставления счета.
¶ Пример 1 (предоплата)
- Выставлять счета каждое 25-ое число - на следующий месяц
- Сразу же рассылать пуш-уведомления абонентам об оплате
- Блокировать должников 1-го числа (можно 24-го, но 26-го — неправильно!)
¶ Пример 2 (постоплата)
- Выставлять счета каждое 1-ое число - на текущий месяц
- Сразу же рассылать пуш-уведомления абонентам об оплате
- Блокировать должников 7-го числа
¶ Пример 3 (постоплата)
- Выставлять счета каждое 1-ое число - на текущий месяц
- Рассылать пуш-уведомления об оплате 25-го числа
- Блокировать должников 1-го числа
¶ Как управлять платежами в Личном Кабинете?
Для партнеров, которые подключили платежи, в Личном Кабинете появляется возможность устанавливать тарифы:
- Для каждой из услуг: Умный Домофон, Железный Домофон, Видеонаблюдение, Калитка
- В том числе, проставить массово всем абонентам тариф Услуги
- А так же, при необходимости, точечно проставить индивидуальные тарифы конкретным абонентам (например, если у абонента “особые” условия)
Указанные тарифы так же можно посмотреть в интерфейсе абонента, в списке всех подключенных услуг:
После выставления счетов они отображаются в разделе “Счета и платежи”, где доступна фильтрация по периоду, по номерам телефонов абонентов и по адресам.
В этом списке отображаются все фактически выставленные счета с детализацией в разрезе услуг и статусом оплаты:
¶ Автоплатежи
Если вы подключились к ЮKassa, ваши абоненты могут настроить автоплатежи. Это избавит их от необходимости оплачивать счета вручную, а вас - от несвоевременных оплат и блокировок.
Подробнее о том, как настроить автоплатежи: Настройка автоплатежей.
Если вы уже нашли настройку в личном кабинете РосДомофон, пожалуйста, прочтите инструкцию по ссылке выше и не пренебрегайте первым шагом.
Автоплатежи не будут работать, пока сервис Ю-Kасса, на своей стороне, не включит этот функционал для ваc.
¶ Полная или частичная блокировка услуг в рамках одного абонента
-
Если вы планируете через наш биллинг блокировать все услуги абонента целиком, следовательно, все услуги необходимо подключать на единый аккаунт. При неоплате абонентом этот аккаунт будет блокироваться целиком.
-
Если вы планируете блокировать одну услугу отдельно от остальных, тогда необходимо подключать услуги на разные аккаунты в рамках одного абонента. Подключать услуги “Умный домофон”,“Калитка”,"Видеонаблюдение" следует по одной и при подключении выбирать нужный аккаунт. Прежде чем заводить второй аккаунт, необходимо дать имя первому аккаунту.
¶ Платежи глазами абонента
В мобильном приложении в разделе “Мои услуги” отображаются все подключенные услуги и тарифы (если тарифы заданы в ЛК). При выставлении счета в этом разделе появляется кнопка оплаты.
После отправки напоминания, статус меняется с зеленого на оранжевый и на главном экране отображается оранжевый баннер с напоминанием об оплате:
После блокировки, статус меняется на красный и на главном экране отображается красный баннер о блокировке и кнопкой оплаты:
¶ Вопросы и ответы
¶ Как заплатить банковской картой?
Ссылка на инструкцию Ю-Касса - https://yookassa.ru/docs/support/payments/instructions/cards
Для оплаты подходят платежные системы: Visa, Mastercard, Maestro, Мир, American Express и JCB
¶ Как абоненту получить чек об оплате?
Данная возможность предоставляется платежным сервисом - Ю-Касса. Например, при оплате через Ю-Кассу банковской картой, у абонента есть возможность указать свой e-mail, куда отправить чек об оплате. Ссылка на инструкцию "Настройка фискализации чеков"
¶ На какой период выставляется счет?
На данный момент предусмотрена помесячная оплата: счета выставляются раз в месяц и должники блокируются так же раз в месяц.
¶ Чем отличаются режимы "Постоплата" и "Предоплата"?
- Режим "Постоплата" создает счета за пользование сервисом в текущем месяце.
- Режим "Предоплата" создает счета за пользование сервисом за следующий месяц.
¶ Если абонент заплатил не через РосДомофон (через банк, по квитанции и т.п.)?
В этом случае автоматика РосДомофон никак не узнает о платеже и абонент будет заблокирован как должник. Чтобы этого не произошло, необходимо пометить счет в ЛК как оплаченный.
¶ Если абонент оплатил счет, но произошла блокировка?
Пожалуйста, проверьте в Личном кабинете ваши настройки:
- Модель оплаты: установлена предоплата или постоплата?
- Даты блокировки и выставления счета: какие числа указаны, какая дата раньше?
Обратитесь в техподдержку за помощью и не забудьте сообщить результаты проверки: это позволит нам решить вопрос быстрее.
¶ Из каких стран возможна работа через Ю-Кассу?
На данный момент, работа биллинга доступна для всех стран действующего СНГ, через систему "Мир".
Дополнительно:
- для Беларуси доступна оплата через платежную систему БЕЛКАРТ, ссылка - https://belkart.by
- для Армении доступна оплата через платежную систему ArCa, ссылка - https://cabinet.arca.am
¶ Могу ли я использовать иное юр.лицо для подключения к Ю-кассе?
Нет, юр.лицо должно быть ровно тем же самым, которое зарегистраровано в ЛК Росдомофона. Как минимум, потому что абоненты должны совершать оплату тому юр.лицу, которое прописано в договоре на оказание услуг.
¶ Могу ли я изменить дату и время каждого задания по выставлению счетов?
Да, в любой момент вы можете изменить день и время ĸаждой задачи, а таĸже посмотреть, ĸаĸой режим оплаты вы выбрали.
¶ Как изменить режим оплаты "Постоплата" на "Предоплата"?
На данный момент, единственным способом изменения режима оплаты является обращение через техподедржку.
¶ Как выгрузить отчет о зачисленных платежах?
В личном кабинете Ю-кассы имеется возможность сформировать и выгрузить отчет (в Excel формате) о всех зачисленных платежах по счетам для абонентов.
Пример выгрузки отчета:
¶ Как изменить api-key магазина?
- В ЛК Ю-кассы yookassa.ru, в разделе меню "Интеграция" - "Ключи API",необходимо заново перевыпустить ключ.
- В ЛК РосДомофон, в разделе меню "Счета и платежи", неоходимо перейти по кнопке "Сменить токен магазина", затем в поле ввода вставить полученный ранее Ключ API из ЛК Ю-кассы.
