Подключение метода оплаты ЮKassa - Платежный модуль

В данной статье рассмотрим подключение метода оплаты "ЮKassa" для интернет-магазина на ADVANTSHOP через "Платежный модуль". Если требуется подключение через "API" перейдите в инструкцию. Если требуется подключение через "Виджет" перейдите в инструкцию

• Подготовка к подключению метода оплаты
• Регистрация в платежной системе
• Настройка в платежной системе
• Настройка метода оплаты на стороне магазина
• Проверка. Тестирование платежей

Внимание!

На текущий момент подключение метода оплаты "ЮKassa" через "Платежный модуль" недоступно для новых клиентов ЮKassa.

Внимание!

Cервис ЮKassa предлагает решение касательно 54-ФЗ для интернет-магазинов, осуществляя отправку фискальных данных из интернет-магазина в облачные кассы. Подробнее: здесь.

 

Подготовка к подключению метода оплаты

Внимание

- Если у Вас магазин на лицензии (приобретён) и работает на отдельном хостинге, то для подключения метода оплаты "Касса от ЮMoney" Вам необходимо приобрести SSL сертификат для доменного имени Вашего магазина. Подробнее об SSL сертификатах.

- Если у Вас магазин в облаке - в этом случае покупать SSL нет необходимости. 

Если у Вас магазин на лицензии и SSL ещё не приобретён, Вам следует отложить вопрос подключения модуля оплаты, и заняться вопросом подключения SSL, т.к. без SSL сертификата технически не получится подключить модуль оплаты.

После того, как вопрос с SSL-сертификатом решён, перейдём к дальнейшим настройкам.

 

Регистрация в платежной системе

Для начала работы нужно подать заявку на подключение ЮKassa и заключить договор с компанией "ЮMoney". Когда у Вас появится личный кабинет на сайте ЮKassa, можно приступать к настройке.

Рекомендуем

Регистрация по вышеуказанной ссылке позволит вам воспользоваться бонусом – подключение со ставкой 2,5% на платежи картами и SberPay на постоянной основе. По остальным методам действуют базовые условия.

В открывшемся окне нажмите на кнопку "Подключить ЮKassa" (рис.1).

Рисунок 1.

На открывшейся странице впишите номер телефона и получите код смс (рис.2).

Рисунок 2.

Далее Вы создаете профиль, либо выбираете существующий (если такой имеется). (рис.3).

Рисунок 3.

Если выбираете существующий, то откроется страница, согласия на переход в новый интерфейс (рис.4). То есть это в случае, если у вас уже была регистрация в ЮKassa и сейчас переносится на ЮKassa.

Рисунок 4.

В нашем случае выбираем первую регистрацию, а именно, создаем новый профиль, откроется страница, где требуется придумать пароль (рис.5).

Рисунок 5.

Далее вводите имя и почту (рис.6).

Рисунок 6.

Выбираете организацию (Юр.лицо, ИП или Самозанятый), вписываете ИНН, если вы самозанятый, то необходимо сначала отправить заявку на подключение и после одобрения пройти регистрацию, подробнее в инструкции. (рис.7).

Рисунок 7.

После того как будет создан личный кабинет, необходимо на вкладку "Прием платежей", в нашем случае выбираете "на сайте" и добавляете доменное имя магазина уже с учетом SSL (рис.8)

Рисунок 8.

Далее нужно указать данные для договора, для этого перейдите в пункт меню "Реквизиты" и заполните все реквизиты компании (рис.9), после чего переходите в "Данные руководителя"- укажите ФИО руководителя, название его должности, гражданство и адрес регистрации (по паспорту), также загрузите сканы паспорта.(рис.10).

Рисунок 9.

Рисунок 10.

Далее перейдите в пункт меню "Юридические вопросы" и добавьте данные бенефициарных владельцев. Если бенефициаров нет — уберите галочку в этом пункте и выберите из списка причину их отсутствия. Затем несколько юридических вопросов. Если выбранный вариант вам не подходит, снимите галочку и выберете подходящий (рис.11).

Рисунок 11.

Когда все пункты заполнены, можно отправлять данные на проверку — в рабочие дни она занимает 1-2 дня. Результат проверки придёт на электронную почту, которую вы указали при регистрации (рис.12).

Рисунок 12.

Настройка в платежной системе

После заключения договора можно начинать настраивать интеграцию ЮKassa с магазином. Сначала опишем настройки на стороне ЮKassa.

Для этого перейдите в пункт меню "Интеграция" - "Готовые решения", в открывшейся странице в поле "Ваша система" выбираете "Advantshop" (рис.13).

Рисунок 13.

Появится поле "Ваш идентификатор в системе" (рис.14) - впишите числовой id из "URL обработки оповещений об оплате (Notification URL)" из настроек интернет-магазина (рис.20).

Рисунок 14.

В разделе "Настройки" - "Магазин" проверьте указанные данные, обязательно должен быть указан ваш домен и протокол "HTTP" (рис.15)

Рисунок 15.

На стороне Юкассы нужно будет указать successURL, failURL, checkURL и avisoURL (рис. 16).

Рисунок 16.

Данные необходимо будет взять из настроек способа оплаты на стороне магазина (рис.17).

Внимание!

- Поле "successURL" в настройках кассы - это "Return url" из настроек магазина.

- Поле "failURL" в настройках кассы - это "Fail Url" из настроек магазина.

- "checkURL" и "avisoURL" – это "Notification URL" из настроек метода оплаты в интернет-магазине.

Для наглядности мы отобразим это на рисунке:

Рисунок 17.

Внимание!

Для магазина в облаке, в параметре "Return url" и "Fail Url" должен присутствовать адрес магазина (домен вашего сайта), а в параметре "Notification URL" указывается специальный адрес "https://gate.advantshop...", это сделано специально, просто скопируйте полный путь и укажите его в настройках на стороне ЮKassa.

Для магазина на лицензии (коробочная версия) во всех трёх параметрах должен присутствовать адрес магазина (домен вашего сайта).

В поле Email укажите электронную почту, на которую будут приходить ежемесячные реестры платежей.

Придумайте пароль магазина и напишите его в поле ShopPassword (нужно 20 символов, желательно – подобранных случайно).

Нажмите "Сохранить", затем "Отправить". Настройки будут проверять специалисты ЮKassa: если все верно, Вы получите shopId и scid, которые нужны для настройки сайта.

Настройка метода оплаты на стороне магазина

После успешной регистрации перейдите в настройки магазина, пункт меню "Настройки" - "Оплата" (рис.18).

Рисунок 18.

На открывшейся странице нажмите "Добавить способ оплаты" и выберите модуль "ЮKassa" (рис.19).

Рисунок 19.

В  настройках метода в строке "Способ подключения" выбираем "Платежный модуль" (рис.20).

Рисунок 20.

1. Укажите shopId и ScId - эти данные возьмите в личном кабинете ЮKassa в настройках магазина (рис.15).

2. Укажите в поле Пароль (для NVP/MD5) соответствующий пароль, введённый Вами ранее в настройках на стороне ЮKassa.

3. Выберите из списка предпочтительный способ оплаты, либо можете выбрать "Умный платеж", тогда на момент оплаты будут доступы все возможные методы оплаты от ЮKassa.

4. В случае, если хотите передавать фискальные данные в облачную кассу через ЮKassa - поставьте галочку "Передавать данные для чека". Подробнее здесь.

Затем, активируйте метод оплаты, выставив галочку "Активен", и сохраните изменения нажав кнопку "Сохранить" внизу страницы.

Также, в случае необходимости, укажите вашу ставку НДС из выпадающего списка.

На этом настройка метода закончена.

 

Проверка. Тестирование платежей

Внимание

Боевые настройки прописываете сразу, поэтому тестовый платеж совершаете на товаре номинальной стоимостью, например, 10 рублей. То есть создаете товар стоимостью 10 руб. и проводите сразу оплату.

Также можно протестировать с помощью тестового магазина на стороне ЮKassa, что это такое и как протестировать ознакомьтесь на сайте ЮKassa в подробной инструкции.

Заметка

Может возникнуть ситуация, когда оплата проходит на стороне кассы, но в магазине не отображается. Для этого, необходимо проверить настройки на стороне ЮKassa.
Перейдите в раздел "Интеграция - HTTP-уведомления", проверьте прописан ли URL для уведомлений (берете из настроек магазина URL обработки оповещений об оплате (Notification URL) (рис.17)) и проверьте включен ли "payment_succeeded ", если не включен или url для уведолмения не прописан, нажмите на кнопку "задать вручную" (рис.19), заполните описанное выше и сохарните (рис.20).

Рисунок 19.

Рисунок 20.

Всё готово.