Яндекс касса для Phoca cart

1. Общая информация

Данный плагин обеспечивает интеграцию Интернет-магазина Phoca Cart c популярной платёжной системой Яндекс Касса, которая, в свою очередь, поддерживает 12 различных способов оплаты. Плагин позволяет передавать данные чеков для соответствия требованиям закона 54-ФЗ.

Системные требования:

  • Joomla 3+
  • Phoca Cart 3.0+
  • Валидный SSL сертификат

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

2. Настройка аккаунта Яндекс Кассы

Для того, чтобы принимать платежи при помощи Яндекс Кассы, вы должны зарегистрироваться по данной ссылке и заполнить форму, приложив сканы документов. После одобрения заявки на ваш E-mail придут данные продавца, которые понадобятся для настройки метода оплаты в Phoca Cart.

Официальная документация:

В личном кабинете Яндекс кассы вам нужно будет заполнить следующие поля:

  • Check/Aviso URL. Пример: https://[yoursite]/index.php?option=com_phocacart&view=response&task=response.paymentnotify&type=yandex_kassa&tmpl=component
  • Success/Fail URL. Пример: -//-
  • Redirect URL. Пример: https://[yoursite]/index.php?option=com_phocacart&view=response&task=response.paymentnotify&type=yandex_kassa&tmpl=component

Ссылки для полей нужно взять из настроек способа оплаты в Phoca Cart. См. параметры аккаунта.

3. Установка плагина

Установка плагина происходит стандартным способом - перейдите в Панель Администратора > Расширения > Менеджер расширений > Установки и загрузите установочный пакет, скачанный с сайта NorrNext.

4. Добавление платёжного метода в Phoca Cart

После успешной установки плагина нам нужно добавить новый платёжный метод в Phoca cart. Для этого перейдём в раздел Оплата (Payments).

Phoca cart - в раздел управления методами оплаты
Phoca cart - переходим в раздел управления методами оплаты

Нажимаем в левой верхней части сайта кнопку Создать.

Добавляем новый метод оплаты в Phoca cart
Добавляем метод оплаты Яндекс.касса в Phoca cart

Настройки и опции сгруппированы по вкладкам:

4.1. Вкладка Главные настройки

  • Заголовок - заголовок платёжного метода. Например: Яндекс Касса
  • Стоимость - стоимость доставки.
  • Ставка налога - выбор налога из существующих вариантов.
  • Тип расчёта - Проценты или фиксированное кол-во. Связан с параметром Стоимость.
  • Метод оплаты - выберите Yandex.Kassa for Phoca Cart
  • Картинка - здесь можете выбрать изображение (логотип) платёжного метода из папки /images/
  • Доступ - Уровень доступа, которым должна обладать группа для просмотра этого объекта.
  • Группа Пользователя - выбор группы пользователя, которому доступен данный метод оплаты. По умолчанию доступен всем.
  • Описание (короткое) - текстовое поле для ввода краткого описания

4.2. Сумма правил

  • Наименьшее значение - установка наименьшего значения
  • Наибольшее значение - установка наибольшего значения
  • Все правила активны - Да / Нет

4.3. Правило зоны

  • Зоны - выберите зоны (множественное значение)
  • Правило зон активно - Да / Нет

4.4. Правило страны

  • Страны - выбор стран
  • Правило страны активно - Да / Нет

4.5. Правила областей

  • Области - введите или выберите несколько вариантов областей
  • Правило области активно - Да / Нет

4.6. Правило доставки

  • Доставка - выбор метода(ов) доставки
  • Активация правила доставки - установка активным правила

Следующая вкладка связана с настройкой данных Яндекс кассы.

4.7. Опции метода оплаты

Указываем параметры аккаунта Яндекс Кассы
Указываем параметры аккаунта Яндекс Кассы
  • Тестовый режим - если включен тестовый режим, то никаких реальных перечислений денег не происходит. Этот режим используется для тестирования платежей.

В Phoca cart имеется опция округления суммы. Данный платёжный метод не поддерживает настройку округления общей суммы до 0 и 1 знака после запятой. Удостоверьтесь, что данная опция отключена!

4.7.1. Статусы заказа

  • Платёж завершён - выберите статус заказа, который будет применён в результате успешного выполнения платёжной транзакции.
  • Ошибочный платёж - Выберите статус заказа, который будет применён в результате неуспешного платежа или ошибки во время обработки платёжной транзакции.
  • Платёж отменён - Выберите статус заказа, который будет применён в результате отменённого платежа.

4.7.2. Параметры аккаунта

  • Shop ID - Укажите идентификатор магазина. Он доступен в личном кабинете после подключения Яндекс.Кассы.
  • SCID ID - Укажите SCID ID. Он доступен в личном кабинете после подключения Яндекс.Кассы.
  • Секретное слово - укажите секретное слово. Он доступен в личном кабинете после подключения Яндекс.Кассы.
  • Check/Aviso URL - скопируйте эту ссылку в поля Check URL и Aviso URL в настройки личного кабинета Яндекс.Кассы.
  • Success/Fail URL - включите «Использовать страницы успеха и ошибки с динамическими адресами» в настройках личного кабинета Яндекс.Кассы
  • Redirect URL - скопируйте эту ссылку в поле Redirect URL в настройках аккаунта Яндекс.Деньги.

4.7.3. Настройка способа оплаты

Яндекс касса для Phoca Cart - передача данных для чеков, система налогообложения и ставка налога
Передача данных для чеков, система налогообложения и ставка налога
  • Данные 54-ФЗ - Отправлять данные для чеков (54-ФЗ) в Яндекс.Кассу. Подробнее.
  • Настройка налога - Слева - ставка НДС в вашем магазине. Справа - в Яндекс.Касса. Пожалуйста, сопаставьте их.

4.8. Настройки публикации

  • Опубликовать - публикация метода оплаты (Да / Нет)

5. Настройка Joomla плагина

Joomla плагин имеет всего одно поле для настройки:

5.1. Вкладка "Ключ Скачивания"

Яндекс Касса для Phoca cart - ключ для скачивания
Яндекс Касса для Phoca cart - ключ для скачивания

При помощи данной опции вы сможете обновить плагин из панели администратора Joomla всего в несколько кликов при помощи Joomla! Update System.

Если вы ввели ключ впервые в данное поле или изменили ключ - пожалуйста, нажмите на кнопку "Обновить", чтобы изменение вступили в силу.

Официальная документация: Включаем обновление в один клик в коммерческих расширениях NorrNext

Убедитесь, что данный Joomla плагин включен!

6. Часто Задаваемые Вопросы

6.1. Что такое 54-ФЗ?

Закон 54-ФЗ «О применении контрольно-кассовой техники» (далее ККТ) регламентирует порядок применения ККТ на территории Российской Федерации. С 1 июля 2017 году вступила в силу поправка в закон 54-ФЗ, которая состоит в изменении схемы работы торговых организаций с налоговыми органами.

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

Полезные ссылки:

6.2. Плагин не поддерживает округление общей суммы до 0 или 1 знака после запятой. Что такое округление и зачем оно нужно?

В некоторых странах применяется бухгалтерское округление общей суммы заказа при расчёте в Интернет магазинах. Такая норма действует, например, в Чешской республике, поэтому разработчиком Phoca cart был заложен данный функционал для универсальности. Логика обработки платежа отличается в различных платёжных системах. При обработке платежа Яндекс касса оперирует не общей суммой заказа, а суммой всех отдельных товаров в рамках одного заказа, что необходимо для соблюдения закона 54-ФЗ. Поскольку округляется сумма каждого товара, то в результате, при округлении общей суммы заказа она никогда не будет совпадать с суммой всех отдельных товаров. Соответственно, платёж обработан не будет.

При использовании Phoca Cart с Яндекс кассой вам нужно отключить параметры округления суммы (Rounding).

Перейдите в Панель Администрирования > Компоненты > Phoca Cart > Настройки > вкладка "Расчёты" и выставите значение Нет для следующих параметров:

  • Rounding Of Total Amount (Calculation) - Нет
  • Rounding Of Fixed Amount (Discount) - Нет
  • Rounding Of Fixed Amount (Coupon) - Нет
6.3. Я не являюсь резидентом РФ и хочу использовать другую валюту для приёма платежей.

В личном кабинете Яндекс кассы у продавца нет возможности выбора валюты и все расчёты происходят в российских рублях. Однако если вы - резидент другого государства, с которым работает Яндекс.Касса, то вам нужно подать заявку в юридический отдел Яндекс Кассы для индивидуального рассмотрения вопроса. Это можно сделать в личном кабинете посредством обращения в поддержку и ваш запрос будет перенаправлен в соответствующий отдел.

В случае положительного принятия решения, валюта продавца будет изменена на указанную в запросе (например, евро, USD, белорусские рубли и др.) См. Приём платежей для нерезидентов. После чего вам нужно выставить в настройках метода оплаты в Phoca cart валюту продавца.

6.4. Ошибка: Сумма заказа не совпадает! Пожалуйста, обратитесь к администратору магазина.

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