Robokassa для Phoca Cart

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

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

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

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

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

Для корректной работы метода оплаты Robokassa ваш хостинг должен соответствовать следующим техническим характеристикам: cURL, PHP 5.3 и выше!

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

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

2.1. Параметры для живых платежей

Технические настройки Robokassa для живого аккаунта
Технические настройки Robokassa для живого аккаунта
  • Алгоритм расчета хеша - выберите MD5
  • Пароль #1 - сгенерируйте и запишите пароль
  • Пароль #2 - сгенерируйте и запишите пароль
  • Result Url - формат: index.php?option=com_phocacart&view=response&task=response.paymentnotify&type=robokassa&tmpl=component
  • Метод отсылки данных по Result Url - выберите POST
  • СМС оповещение на телефон - опционально
  • Success Url - формат: index.php?option=com_phocacart&view=response&task=response.paymentnotify&type=robokassa&tmpl=component
  • Метод отсылки данных по Success Url - выберите POST
  • Fail Url - формат: index.php?option=com_phocacart&view=response&task=response.paymentcancel&type=robokassa&tmpl=component
  • Метод отсылки данных по Fail Url - выберите POST

Метод отсылки данных везде должен быть выставлен как POST!

Примечание: в полях URL нужно указывать адрес вашего домена и далее ссылки. Пример:

https://mysite.ru/index.php?option=com_phocacart&view=response&task=response.paymentnotify&type=robokassa&tmpl=component

2.2. Параметры проведения тестовых платежей

Параметры проведения тестовых платежей Robokassa
Параметры проведения тестовых платежей Robokassa
  • Алгоритм расчета хеша - выберите MD5
  • Пароль #1 - сгенерируйте и запишите пароль
  • Пароль #2 - сгенерируйте и запишите пароль

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

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

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

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

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

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

Добавляем новый метод оплаты в Phoca cart
Добавляем метод оплаты Robokassa в Phoca cart

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

4.7.2. Параметры магазина

  • ID магазина - укажите идентификатор магазина. Он доступен в настройках магазина Робокассы.
  • Алгоритм хеша - укажите алгоритм расчёта хеша. Он доступен в настройках магазина Робокассы. Значение должно быть MD5!
  • Пароль #1 - укажите пароль #1. Он доступен в настройках магазина Робокассы.
  • Пароль #1 - укажите пароль #2. Он доступен в настройках магазина Робокассы.
  • Result/Success/Fail URL - скопируйте эту ссылку в поля Result URL, Success URL и Fail URL настроек магазина Робокассы.

4.7.3. Параметры тестовых платежей

  • Параметры тестовых платежей - укажите алгоритм расчёта хеша. Он доступен в настройках магазина Робокассы.
  • Пароль #1 - укажите пароль #1. Он доступен в параметрах проведения тестовых платежей настроек магазина Робокассы.
  • Пароль #2 - укажите пароль #2. Он доступен в параметрах проведения тестовых платежей настроек магазина Робокассы.
  • Алгоритм хеша - укажите алгоритм расчёта хеша. Он доступен в настройках магазина Робокассы. Значение должно быть MD5!

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

Robokassa для Phoca Cart - передача данных для чеков и налоги
Передача данных для чеков и налоги
  • Отправлять валюту - способ указать валюту, в которой магазин выставляет стоимость заказа. Этот параметр нужен для того, чтобы избавить магазин от самостоятельного пересчета по курсу. Если включено, то плагин отправляет параметр OutSumCurrency и Робокасса показывает полную сумму заказа, конвертированную в рубли по курсу ЦБ на момент оплаты. Код валюты должен быть USD, EUR или KZT.
  • Данные 54-ФЗ - Отправлять данные для чеков (54-ФЗ) в Робокассу. Подробнее.
  • Система налогообложения - параметр необходим, только если у вас несколько систем налогообложения.
  • Настройка налога - слева - ставка НДС в вашем магазине. Справа - в Робокасса. Пожалуйста, сопаставьте их.

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

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

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

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

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

Robokassa для Phoca cart - ключ для скачивания
Robokassa для 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. Ошибка: Сумма заказа не совпадает! Пожалуйста, обратитесь к администратору магазина.

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

6.4. Как подключить дополнительные способы оплаты?

Управление способами оплаты осуществляется на стороне Robokassa в личном кабинете продавца.