Плагин Яндекс Кассы (1.0.4) для Joomla Phoca Cart
Плагин Yandex Kassa для Joomla Phoca Cart позволяет подключать интернет-магазин на базе Phoca Cart к Yandex.Kassa и принимать платежи всеми доступными в Kassa.Yandex методами с обеспечением требований 54-ФЗ (стыковка с онлайн кассами и операторами фискальных данных).
Phoca Cart - это бесплатный компонент, позволяющий на бесплатной CMS Joomla быстро создать вполне приличный и функциональный интернет магазин (см. https://phoca.cz/phocacart).
Плагин yandex_kassa на текущий момент совместим с Joomla 3.8 и компонентом Phoca Cart версии 3.1.1.
Плагин взаимодействует с сервисом kassa.yandex.ru посредством API (сервис обеспечивает взаимодействие посредством API и HTML формы. API потенциально более функциональный способ взаимодействия, а так же, более безопасный (позволяет проверить, действительно ли сервис подтвердил проведение платежа, а не просто верить обратному вызову…)).
Настройка на стороне Яндекс.Касса
Интеграция по API и порядок подключения подробно описан здесь https://kassa.yandex.ru/integration-with.html
Для тестового взаимодействия с Яндекс кассой вам можно даже не регистрироваться, т.к. тестовый магазин доступен всем и он один на всех и к сожалению, т.к. он "один на всех", то он не делает обратный вызов вашего сайта (т.е. проверить, как реагирует Яндекс.Касса на ваш запрос можно, а вот ответа от тестового магазина Яндекс.Кассы вы не получите)… Т.о. если вы желаете настроить систему и пока просто попробовать тестовое взаимодействие, то можно сразу переходить к настройке плагина. Если же вы сразу хотите настроить и тестовое, и реальное взаимодействие, то вам обязательно надо зарегистрироваться в сервисе kassa.yandex.ru, подать заявку на подключение и после подключения попросить закрепленного менеджера включить режим взаимодействия через API (на момент написания этого текста Яндекс касса по умолчанию включала режим взаимодействия через форму и переключение на API осуществлялось закрепленным за вами менеджером. Возможно, когда вы читаете эти строки, что-то уже в этом порядке изменилось).
И так, после включения режима взаимодействия через API, вы увидите настройки вашего магазина в сервисе примерно в таком виде (см. ниже)
Обращаем внимание на необходимые и не очень, параметры:
Тип онлайн-кассы – Здесь выбран «Orange Data». Выбор за вами. Смотрите список доступных в описании Яндекс Кассы и выбирайте.
Почта для ошибок – e-mail, на который сервис будет слать ошибки.
Название, которое увидит покупатель – ну здесь наверное ООО «Наименование ООО…» или что-то подобное…
ShopID – Идентификатор магазина, горит в верхней части формы и внизу. Вы его будет задавать в настройке метода оплаты в Phoca Cart.
Способ подключения к Яндекс.Кассе – менеджер поставил JoomlaShopping, хотя общее у нас – это то, что и JoomlaShopping и Phoca Cart работают на Joomla…
Протокол - API (как писалось выше, включается по заявке)
Адрес для уведомлений – задается адрес на вашем сайте, на который сервис Яндекс.Касса будет отвечать (сообщать, прошел платеж или нет). В нашем случае это:
https://ВАШ_ДОМЕН/index.php?option=com_phocacart&view=response&task=response.paymentnotify&tmpl=component&type=spn_yandex_kassa
Почта для реестров – e-mail, на который будут ежедневно приходить реестры покупок и возвратов
Секретный ключ для API – генерится сервисом Яндекс.Касса. Вы его используете при настройке метода оплаты в Phoca Cart.
Настройка на стороне Phoca Cart и плагина для Yandex Kassa
Скачиваем архив с плагином (plg_pcp_spn_yandex_kassa.zip) , устанавливаем его стандартным образом и делаем его действующим (т.е. включаем его – должен гореть зеленый крыж «состояние» как указан на рисунке ниже).
После установки и включения плагина идем в методы оплаты в компоненте «Phoca Cart»
и добавляем (создаем) необходимые нам методы оплаты, как указано на рисунке ниже (можно один, а можно несколько - связать каждый вид оплаты Яндекс.Кассы с отдельным методом оплаты в Phoca Cart).
На закладке «Главные настройки» задаем наименование метода оплаты, его стоимость (если за такой метод вы собираетесь брать дополнительные деньги, например, хотите компенсировать с клиента стоимость эквайринга) и другие параметры, а так же выбираете метод оплаты «SPN Yandex Kassa» (этот метод должен появиться после установки плагина Yandex.Kassa).
После выбора метода оплаты на закладке «Главные настройки» настраиваем выбранный метод оплаты на закладке «Опции метода оплаты»
Рассмотрим опции метода оплаты более внимательно:
Тестовый режим – позволяет переключаться между реальным магазином и тестовым. Тестовый магазин в режиме взаимодействия с Яндекс кассой один на всех! Т.о. для тестирования вам даже необязательно регистрироваться в Yandex.Kassa. Вам достаточно выбрать тестовый магазин, внести его параметры (см. ниже) и попробовать провести платеж…
ShopID - уникальный ID вашего магазина. Берем из настроек Яндекс.Кассы
Секретный код - Берете секретный ключ API из настроек Яндекс.Кассы
Test:ShopID - ID тестового магазина. Смотрим в разделе «Тестовый магазин»
Test:Секретный код - секретный ключ API тестового магазина. Смотрим в разделе «Тестовый магазин»
Задаем метод оплаты – Да/Нет. Если «Да», то заводимому методу оплаты (мы назвали «Банковские карты (Yandex)» на форме оплаты будет только один метод, выбранный в следующем параметре «Метод оплаты». Если же выберете «Нет», то на форме оплаты появятся все доступные методы оплаты (см. в следующем параметре «Методы оплаты» доступные методы.
Проверка платежа – Включить ли проверку обратного вызова сервиса для реальной проверки платежа. По технологии, плагин «просит» Яндекс.Кассу создать форму приема платежа передав в нее параметры покупки. В ответ Яндекс.Касса зовет сайт для того, что-бы сообщить, прошел платеж или нет (см. описание параметра «Адрес для уведомлений» в описании сервиса Яндекс.Касса). При выключенной «Проверке платежа» положительное сообщение просто переводит статус заказа из состояния «В ожидании» в «Подтверждено». При включенной «Проверка платежа» плагин делает еще запрос к сервису и сам получает обновленный статус платежа.
Налогообложение – выбираем необходимую систему налогообложения получателя платежа.
НДС – выбираем используемый НДС (нет, 20% и т.д.).
Признак предмета расчета – введен ФФД 1.05 – с 01.01.2018 обязательный реквизит чека. Выбирается из числа доступных.
Признак способа расчета – введен ФФД 1.05 – с 01.01.2018 обязательный реквизит чека. Выбирается из числа доступных.
Пример вызова Яндек.Кассы с незаданным видом платежа (видим на форме доступные виды платежей и можем их выбирать)
Пример вызова Яндек.Кассы с заданным видом платежа (видим на форме только заданный вид платежа – в данном случае, банковская карта)
Ну и конечно, не забудьте опубликовать созданный метод оплаты…
Тестовый магазин
Описание тестирования и тестовый магазин для API описан:
На момент написания этого текста параметры тестового магазина:
Shopid = "54401"
api_key= "test_Fh8hUAVVBGUGbjmlzba6TB0iyUbos_lueTHE-axOwM0"
Тестовая карта для этого магазина:
1111111111111026, срок действия: 12 25
CVC : 000 (3D-Secure отключен) или 123 (3D-Secure включен)
Скачать плагин
Скачать плагин можно на странице загрузок: http://seoprosto.net/other/download
Другие плагины
Если вам необходим плагин для оплаты в других банках или помощь в настройке - пишите на Адрес электронной почты защищен от спам-ботов. Для просмотра адреса в вашем браузере должен быть включен Javascript.
Доработки модуля
Если у вас есть предложения по доработке модуля - присылайте их на e-mail: Адрес электронной почты защищен от спам-ботов. Для просмотра адреса в вашем браузере должен быть включен Javascript.
