Документация ЮKassa PRO (Расширенный протокол)

Лицензионный ключ отправляется автоматически на почту аккаунта покупателя, если письма Вы не нашли, проверьте папку спам, если письмо в спаме, то пожалуйста поставьте отметку не спам. При отсутствии ключа в папке спам напишите в поддержку.

Купить модуль можно по ссылке.
Зарегистрируйтесь по ссылке и получите особые условия: комиссия 2,8% за платежи картами, кошельком ЮMoney и через SberPay — независимо от оборота.

Последние версии модулей:
Магазины 1.5 - 4.3 (oc1.5)
Магазины 2.0-2.1 - 4.2 (oc2.0-2.1)
Магазины 2.2 - 4.2 (oc2.0-2.1)
Магазины 2.3 - 4.2 (oc2.3)
Магазины 3.0 - 5.7 (oc3.0)

Содержание:

  I. Установка
     a) Магазины 3, 2.3, 2.2, 2.1, 2.0
     b) Магазины 1.5
 II. Настройка
 III.  Обновление версии модуля
IV.  Переход с модуля от ЮКассы
V. FAQ
  VI. Настройка Признака предмета расчета и Признака способа расчета
VII. Активация отложенной оплаты

I. Установка

Внимание! Архивы подписаны версией магазина, разные архивы для разных версий не совместимы. В названии архива префикс _for_

Если Вы не нашли архив для своей версии магазина напишите нам, мы добавим данный архив в загрузки.

 

a) Магазины 3, 2.3, 2.2, 2.1, 2.0

Автоматическая установка:

  1. Разархивируйте архив, внутри архива 2 файла - readme.txt и yandexur-pro.ocmod.zip
  2. В админ панели сайта меню Дополнения - Установка дополнений - Загрузите архив yandexur-pro.ocmod.zip
  3. Если возникли ошибки с установщиком - проверьте настройки фтп или установите расширение по ссылке (также возможна установка вручную - см. пункт Установка вручную)
  4. Меню Менеджер дополнений (Модификации) - обновите кэш модификаций
  5. Установите нужные модули в разделе Дополнения - платежи (Оплата)

Установка вручную:

  1. Разархивируйте архив, внутри архива 2 файла - readme.txt и yandexur-pro.ocmod.zip
  2. Разархивируйте архив yandexur-pro.ocmod.zip, внутри папка upload и файл install.xml
  3. С помощью файлового доступа к сайту (ftp или ssh) загрузите все содержимое папки upload в корень сайта
  4. Переименуйте install.xml в yandexur.ocmod.xml
  5. В админ панели сайта меню Дополнения - Установка дополнений - Загрузите файл yandexur.ocmod.xml
  6. Меню Менеджер дополнений (Модификации) - обновите кэш модификаций
  7. Установите нужные модули в разделе Дополнения - платежи (Оплата)

 

b) Магазины 1.5

  1. Разархивируйте архив, внутри архива 2 объекта - readme.txt и папка upload
  2. С помощью файлового доступа к сайту (ftp или ssh) загрузите все содержимое папки upload в корень сайта
  3. Установите нужные модули в разделе Дополнения - платежи (Оплата)

 

II. Настройка

  1. Отправьте заявку на подключение к ЮКассе по ссылке
  2. У Вас появится личный кабинет - далее ЛК
  3. Заполните копии документов в ЛК
  4. Подпишите договор
  5. Во вкладке Настройки нажмите Заполнить. Выберите способ подключения API протокол и нажмите Продолжить.
  6. Укажите адреса для уведомлений и включите все уведомления.
  7. Нажмите далее

  8. Выберите, как отправлять данные для чеков:

    Через ЮКассу — в этом случае вам нужно будет подключить онлайн-кассу одного из партнеров якассы. - Настройка взаимодействия с онлайн-кассой
    Решить позже — если вы точно не знаете, что делать с фискализацией, можете начать подключение, а эти настройки заполнить позже.
    Самостоятельно — платежи через ЮКассу проходят как обычно, фискальные данные в свою онлайн-кассу отправляете вы (вручную или через другой сервис).

  9. Нажмите отправить.

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

  11. Для банковских карт доступен выбор Способа транзакции (ТОЛЬКО API протокол) :
    Одностадийная - деньги списываются с карты без дополнительных подтверждений
    Двухстадийная - деньги блокируются на карте покупателя. У Вас есть 7 дней на подтверждение платежа банковской картой. Если вы не подтвердите платеж в отведенное время, деньги вернутся покупателю. Как только вы уверены в том, что готовы оказать услугу или выдать товар, необходимо подтвердить платеж. Если вы не можете оказать услугу или выдать товар, необходимо отменить платеж. Деньги вернутся пользователю, ЮКасса не будет удерживать комиссию за его проведение.

  12. Установите статус модуля "включено" и сохраните настройки

  13. ВНИМАНИЕ! Статусы заказов должны быть разные (созданный, оплаченный - либо при схеме отложенная или контроль наличия созданный, ожидание, оплаченный)

 

 

 

III. Обновление версии модуля

  1. Обязательно сделайте бекап файлов сайта и базы
  2. Удалите модификатор модуля(меню модификаторы или менеджер дополнений или папка system) если вы используете его (только для версии магазинов 2.х)
  3. Установите модуль перезаписав файлы , пройдите все шаги установки.
  4. Обновите кеш модификаторов (только для версии магазинов 2.х и 3.х)
  5. Обязательно вставте заново api_key. Пересохраните настройки, если нужно внесите изменения в настройки
  6. Убедитесь что адрес уведомлений не изменились как в модуле так и на стороне ЮKassa, и также включены все переключатели в уведомлениях юкасса в кабинете
  7. Для магазинов 3х обновите кеш twig (главная страница админ панели, шестеренка справа вверху)

IV. Переход с модуля от ЮКассы

  1. Удалите или отключите оплату родного модуля ЮКассы
  2. Установите модуль
  3. Смените адрес уведомлений или  checkUrl и AvisioUrl на стороне яКассы в ЛК
  4. Частично повторите пунк II Настройки

 

V. FAQ

1.  При переходе на оплату текст No Data
В настройках модуля включите режим отладки, последняя строчка - это ошибка от юкассы

Также ошибки от No Data доступны в журнале магазина без включения режима отладки.

Данная ошибки это ответ от юкассы, читайте текст, самое частое неверная авторизация (shopid или api) или не корректный пароль -пробелы в начале в конце(Password has illegal format), метод недоступен на стороне Юкассы (подключите через менеджера), метод не доступен в модуле (на данный момент для api не доступен альфа-клик, промсвязьбанк, мобильный терминал, Masterpass, купивкредит, Ерип - данные методы только для старого протокола HTTP)

2. Расшифровка ошибок из лога магазина (журнал ошибок)

YandexUr Error: Hash not equal - не сходиться секретная фраза указанная в настройках модуля и написанная в анкете

YandexUr Error: Amount of payment not equal - не сходится сумма, оплата прошла на одну а в заказе другая.

YandexUr Error: This order alredy payed - заказ уже оплачен

Другие ошибки это ответ от Юкассы, читайте текст, самое частое неверная авторизация (shopid или api), метод недоступен на стороне Юкассы (подключите через менеджера), метод не доступен в модуле (на данный момент для api не доступен альфа-клик, промсвязьбанк, мобильный терминал, Masterpass, купивкредит, Ерип - данные методы только для старого протокола HTTP)

3. Как добавить иконку к методу оплаты

     В настройках модуля

     поле название метода оплаты добавить тег img (что такое тэг img и как он работает описано по ссылке)

     <img src="путь к картинке" /> Юmoney

4. Некорректно отображаются страницы успешной, неуспешной оплаты и страница повторной оплаты

Магазины 1.5, 2.0, 2.1, 2.2, 2.3
Необходимо привести tpl модуля в соответвие вашего шаблона (за эталон возьмите common/success.tpl)
скопируйте шаблоны модуля сatalog⁩/view⁩/theme⁩/default⁩/template⁩/account⁩/
yandexur_fail.tpl
yandexur_success.tpl
yandexur.tplв папку вашего шаблона по соответвующему пути, исправте верстку в них под ваш шаблон

Магазины 3.х
Необходимо привести tpl модуля в соответвие вашего шаблона (за эталон возьмите common/success.tpl)
скопируйте шаблоны модуля сatalog⁩/view⁩/theme⁩/default⁩/template⁩/extension/payment/
yandexur_fail.twig
yandexur_success.twig
yandexur_view.twig
в папку вашего шаблона по соответвующему пути, исправте верстку в них под ваш шаблон

5. Не отображается ссылка повторной оплаты в личном кабинете
кнопку можно добавить в настройках модуля в комментарии в письмо - поле иснтрукция в письме добавьте переменную ссылки, ссылка будет отображатся в просмотре заказа, для кнопки создайте тег а и наделите его стилями

Исправления под шаблон

Магазины 1.5
Отредактируйте xml файл из папки vqmod
блок catalog/view/theme/*/template/account/order_list.tpl в соответвии с вашим шаблоном

Магазины 1.5, 2.0, 2.1, 2.2, 2.3
Удалите модификатор, откройте архив модуля файл instal.xml
отредактируйте блок catalog/view/theme/*/template/account/order_list.tpl в соответвии с вашим шаблоном
переименуйте файл в yandexur.ocmod.xml  и установите через установщик, обновите кеш модификаторов

Магазины 3.х
отредактируйте сatalog⁩/view⁩/theme⁩/default⁩/template⁩/extension/payment/yandexur_aclink.twig
обновите кеш шаблонов twig

VI. Настройка признака способа и предмета расчета

В настройках модуля укажите Признак способа и предмета расчета - эти данные будут использоваться по умолчанию если вы выберите Признак предмета и/или способа для товара - пункт по умолчанию

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

Для индивидуальных значений необходимо выбрать поле из которого будет браться значение, список полей доступен в выпадающем списке.

Для значений в карточке товара указываете в нужном поле одно из следующих значений

Признак предмета расчета

Значение Описание
commodity Товар
excise Подакцизный товар
job Работа
service Услуга
gambling_bet Ставка в азартной игре
gambling_prize Выигрыш в азартной игре
lottery Лотерейный билет
lottery_prize Выигрыш в лотерею
intellectual_activity Результаты интеллектуальной деятельности
payment Платеж
agent_commission Агентское вознаграждение
composite Несколько вариантов
another Другое

 

Признак способа расчета

Значение Описание
full_prepayment Полная предоплата
partial_prepayment Частичная предоплата
advance Аванс
full_payment Полный расчет
partial_payment Частичный расчет и кредит
credit Кредит
credit_payment Выплата по кредиту

 

VII. Активация отложенной оплаты

Для активации оплаты, необходимо в просмотре(не редактировании) заказа(это кнопка глаз в oc 2х-3х) установить статус из настроек модуля - Статус для активации Отложенной оплаты и установить галку уведомить покупателя, нажать кнопку добавить историю
ВНИМАНИЕ! Работает только в просмотре заказа, редактирование не отправляет письмо о смене статуса заказа, модуль использует стандартное письмо магазина и вставляет туда ссылку, если Вы используете шаблонизатор писем или исправили стандартные письма о смене статуса магазина, ссылка может не появиться в письме.
Для работы отложенной оплаты обязательно наличие модификатора в разделе Менеджер дополнений(Модификаторы) и обновленный кеш модификаторов (там же кнопка вверху стрелки по кругу)