Robokassa: инструкции по настройке
Перед началом работы необходимо зарегистрироваться на сайте сервиса приема онлайн-платежей Robokassa.
Откройте в браузере две вкладки — настройки проекта в Панели управления Taptop и личный кабинет на сайте Robokassa.
В личном кабинете Robokassa в разделе «Управление» перейдите на вкладку «Мои магазины» и нажмите кнопку «Добавить новый». Если вы уже создали магазин ранее, переходите к следующему шагу.
Заполните регистрационные данные магазина:
- Наименование магазина, которое будут видеть посетители при оплате.
- Идентификатор магазина, который позднее нужно будет вставить в настройки проекта в Taptop.
- Почтовый адрес.
- URL-адрес главной страницы вашего сайта.
- Способ вывода средств — добавьте расчетный счет магазина.
- Ответственное лицо — добавьте ответственного за проект, указав ФИО, должность, e-mail и номер телефона.
- Тех. поддержка — добавьте администратора или другого сотрудника, отвечающего за поддержку пользователей.
После заполнения данных нажмите кнопку «Создать».
Перейдите на вкладку «Технические настройки» и установите два пароля — Пароль #1 и Пароль #2. Они не должны совпадать. Вы можете также создать пароли автоматически, нажав на кнопку «Сгенерировать» справа от каждого поля.
В разделе «Параметры проведения тестовых платежей» установите Пароль #1 и Пароль #2, которые будете использовать для тестовой проверки оплат, или сгенерируйте их автоматически.
Значения паролей для тестового режима должны отличаться от значений для рабочей среды, иначе тестовый режим не будет работать. Рекомендуем отдельно сохранить пароли, установленные для рабочей среды.
Перейдите на сайт Taptop и откройте настройки проекта, нажав на три точки в карточке проекта и выбрав пункт меню «Настройки».
Перейдите в раздел «Интеграции» — «Платежные системы» и нажмите кнопку «Добавить платежную систему».
Выберите из списка Robokassa.
Выберите валюту оплаты. Для Robokassa доступны:
- рубли (RUB);
- доллары (USD);
- казахстанский тенге (KZT);
- евро (EUR).
Ниже откроются дополнительные поля, но они понадобятся вам позже.
Если вам необходимо использование нескольких валют, вы можете подключить несколько интеграций с Robokassa — по одной для каждой валюты. Для этого нужно будет повторить процесс добавления платежной системы для каждой валюты.
Название валюты автоматически добавляется в скобках к названию платежной системы. Например, если вы подключите два варианта интеграции с Robokassa — с рублями и с долларами, то они будут выглядеть следующим образом — Robokassa (RUB) и Robokassa (USD).
1) В личном кабинете Robokassa — на вкладке «Технические настройки» скопируйте Идентификатор магазина.
На сайте Taptop в настройках платежной системы — вставьте идентификатор в поле «Логин».
2) Далее аналогичным образом вам необходимо перенести значения паролей из Robokassa в Taptop.
Сначала желательно проверить работу платежей в тестовом режиме. Для этого нужно взять тестовые пароли в Robokassa из раздела «Параметры проведения тестовых платежей».
На сайте Robokassa скопируйте поочередно тестовые пароли Пароль #1 и Пароль #2 и вставьте их в поля «Пароль продавца 1» и «Пароль продавца 2» в настройках в Taptop.
Далее заполните следующие параметры:
- Комиссия. В поле «Комиссию оплачивает продавец» выберите «Да» — если оплату комиссии берет на себя магазин или «Нет» — если комиссия останется на покупателе.
- Язык — почти всегда вам нужен русский язык. Исключение, когда у вас есть англоговорящие клиенты, то выберите английский.
Без этой настройки платежи в Taptop работать не будут!
Чтобы настроить уведомления:
1) На сайте Taptop в настройках платежной системы найдите поля «Result URL», «Success URL» и «Fail URL».
Вам необходимо поочередно скопировать ссылки из этих полей и перенести их в настройки в Robokassa.
2) На сайте Robokassa вставьте ссылки «Result URL», «Success URL» и «Fail URL» из настроек Taptop в одноименные поля.
Также установите параметры «Метод отсылки данных» для каждого из этих URL в значение POST.
3) Нажмите кнопку «Сохранить».
1) На сайте Taptop в поле «Тестовый режим» выберите значение «Да».
2) Чтобы завершить подключение платежной системы в тестовом режиме, нажмите кнопку «Подключить» внизу страницы.
* На этом этапе не требуется заполнять остальные поля формы.
3) На вашем сайте создайте форму оплаты. Подробная инструкция по созданию формы оплаты.
4) Чтобы проверить, правильно ли работает оплата, оформите на вашем сайте тестовый заказ и проведите по нему оплату.
Перейдите в раздел «Заявки» в настройках проекта и проверьте статус заказа. При успешной оплате вы увидите статус «Оплачен».
Если возникла ошибка или операция не работает так, как нужно, то повторите действия еще раз. Если ошибка повторяется, свяжитесь со службой поддержки Robokassa.
Почему после совершения оплаты нет уведомления об ее подтверждении?
На данный момент интеграция платежей в Taptop работает так, что после оплаты вас сразу перебрасывает на ваш сайт. Посмотреть подтверждение оплаты можно в настройках проекта в Taptop в разделе «Заявки».
Если у вас возникла ошибка при совершении платежа, перезагрузите страницу сайта.
Дополнительные настройки платежной системы используются для транзакций, которые передаются в платежный сервис. Это может понадобиться для ФНС.
На сайте Taptop настройте следующие параметры:
- Налог, название и процент — Необязательные поля, используются редко. Поля для указания налогов. По умолчания опция выключена. Чтобы добавить налог, переключите свитчер и введите его название и значение в процентах. Если вы добавите налог, то все транзакции, которые будут созданы с данной системой оплаты, будут идти с надбавкой на величину налога.
- Признак предмета платежа. Выберите, что именно вы продаете.
- Признак способа платежа — полный расчет или полная предоплата. Этот параметр используется для системы фискализации.
На момент написания этой документации (22 августа 2024 года) корректно работает только полный расчет.
Если вам нужна полная предоплата, то напишите в службу поддержки Taptop — узнайте о возможности подключения.
Полный расчет означает то, что продажа товара и услуги происходит мгновенно с его выдачей. На практике это не обязательно происходит так, то есть вы можете передать товар и позже — но по закону, если строго соблюдать процедуру, должен быть второй чек. В реальности эти правила не соблюдаются столь строго, поэтому выбирайте нужную вам опцию на ваше усмотрение, и желательно посоветовавшись с вашим бухгалтером.
Полная предоплата подразумевает 2 чека: первый — когда вы получили деньги, второй — когда вы передали товар заказчику.
- Система налогообложения — выберите используемую систему расчета налогов.
Для отправки клиентам чеков об оплате включите фискализацию.
На сайте Robokassa настройте онлайн-кассу.
Узнать подробную информацию об онлайн-кассе и оставить заявку на ее подключение вы можете на сайте Robokassa.
После подтверждения от Robokassa, что касса работает, — на сайте Taptop включите использование онлайн-кассы. Для этого перейдите в настройки платежной системы в Taptop и выберите значение «Да» в поле «Фискализация».
Теперь Robokassa будет сама формировать чек после оплаты и отправлять его клиенту.
Система налогообложения по умолчанию (пустое поле)
Эта опция требуется редко. Для ее настройки и выяснения подробностей, напишите в службу поддержки Taptop через виджет справа внизу страницы.
1) На сайте Robokassa в настройках активируйте ваш магазин. Для этого нажмите на кнопку «Запрос на активацию» и дождитесь сообщения о завершении активации от специалистов Robokassa — это может занять некоторое время.
2) На сайте Taptop в настройках проекта переведите систему в рабочий режим, выбрав «Нет» в поле «Тестовый режим».
3) На сайте Taptop замените пароли с тестовых на рабочие.
На сайте Robokassa скопируйте поочередно Пароль #1 и Пароль #2 и вставьте их в поля «Пароль продавца 1» и «Пароль продавца 2» в настройках в Taptop.
4) В настройках в Taptop нажмите кнопку «Подключить» внизу страницы.
Готово! Интеграция с платежной системой Robokassa настроена.
Для каждого товара необходимо создать отдельную форму оплаты. Инструкция.