ЮKassa для Phoca Cart

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

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

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

Установка плагина осуществляется через установщик маркетплейса SovMart.

Обновление всех расширений осуществляется в несколько кликов также через установщик SovMart. В настройках установщика вам указать ключ, который можно взять в личном кабинете маркетплейса. Ознакомьтесь, как установить плагин и правильно настроить обновление расширений в соответствующей статье:

Установка и настройка обновлений расширений в несколько кликов

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

• Подключение ЮKassa (для юридических лиц)
• Тестирование оплаты

Для настройки магазина в ЛК ЮKassa, вам необходимо авторизоваться на сайте сервиса и перейти в личный кабинет.

1. Настройки > Магазин – скопируйте значение ShopID для дальнейшего использования в методе оплаты на стороне RadicalMart.

2. Перейдите в раздел Интеграция – Ключи API и сгенерируйте Секретный ключ. Этот ключ нужно будет вставить в настройках способа оплаты на стороне Phoca Cart.

3. Для смены статуса заказа после оплаты, необходимо указать callback.
Перейдите в Интеграция > HTTP-уведомления и в параметре URL для уведомлений укажите callback значение из настроек метода оплаты:

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

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

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

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

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

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

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

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

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

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

• ShopId - Укажите идентификатор магазина. Он доступен в личном кабинете после подключения ЮKassa. См.подробнее
• Секретный ключ - укажите секретный ключ. Он доступен в личном кабинете после подключения ЮKassa.
• URL для уведомлений - скопируйте ссылку с http запросом и вставьте его в настройки личного кабинета ЮKassa. См.подробнее.

Для настройки интеграции с онлайн-кассами, перейдите в Настройки > Онлайн-касса:

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

В настройках метода оплаты перечислены параметры, которые задействованы при формировании данных, которые будут задействованы при передаче фискальных данных.

• Система налогообложения.
  • Не передается
  • Общая система налогообложения (доход)
  • Упрощенная система налогообложения (доход)
  • Упрощенная система налогообложения (доход минус расход)
  • Единый налог на вменённый доход
  • Единый сельскохозяйственный налог
  • Патентная система налогообложения
• НДС.
  • без НДС
  • НДС по ставке 0%
  • НДС чека по ставке 10%
  • НДС чека по расчетной ставке 10/110
  • НДС чека по ставке 20%
  • НДС чека по расчетной ставке 20/120
• Способ расчёта.
  • Не передается
  • Полная предоплата
  • Частичная предоплата
  • Аванс
  • Полный расчёт
  • Частичный расчёт и кредит
  • Кредит
  • Выплата по кредиту
• Предмет расчёта.
  • Не передается
  • Товар
  • Подакцизный товар
  • Работа
  • Услуга
  • Ставка азартной игры
  • Выигрыш азартной игры
  • Лотерейный билет
  • Выигрыш лотереи
  • Предоставление РИД
  • Платеж
  • Агентское вознаграждение
  • Составной предмет расчёта
  • Иной предмет расчёта
  • Имущественное право
  • Внереализационный доход
  • Страховые взносы
  • Торговый сбор
  • Курортный сбор

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

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

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

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

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

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

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

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

• Rounding Of Total Amount (Calculation) - Нет
• Rounding Of Fixed Amount (Discount) - Нет
• Rounding Of Fixed Amount (Coupon) - Нет

6.3. Я не являюсь резидентом РФ и хочу использовать другую валюту для приёма платежей.

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

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

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

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

Перейдите в панель администрирования > Компоненты > Phoca Cart > Системный журнал. Здесь можно изучить логи операций. Подробнее здесь.

У вас отсутствуют или некорректно настроены callback ссылки в Личном кабинете ЮKassa. Подробнее о настройке.

В настройках магазина используется некорректный ключ или подписка на продукт просрочена. Необходимо продлить подписку в личном кабинете sovmart.ru и/или проверить ключ.