2Checkout Inline for Phoca Cart

1. Начало работы

Данный плагин обеспечивает интеграцию 2Checkout с Phoca Cart - компонента Интернет-магазина для Joomla. 2Checkout - сервис для приёма глобальных платежей, который охватывает более чем 200 рынков и позволяет вам максимизировать онлайн-продажи.

Требования:

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

Для обеспечения безопасной передачи данных пользователей вам необходим валидный SSL сертификат!

Примечание: Платёжная система 2Checkout имеет несколько режимов для приёма платежей: Standard, Payment API и Inline. Данный плагин работает в режиме 2Checkout Inline.

2. Настройки аккаунта 2Checkout

Прежде всего, вам нужно настроить аккаунт пользователя в личном кабинете 2Checkout и взять там некоторые настройки для использования в Phoca Cart. Авторизутесь в панели пользователя 2Checkout, затем перейдите в Account > Site Management

Следующие параметры важно заполнить:

  • Demo Setting - Демо режим (Да, Нет или Параметр - что означает контроль на стороне плагина)
  • URL: обязательный параметр. Вы можете ввести URL единожды, поэтому будьте аккуратны.
  • Pricing currency - Выберите валюту, используемую в магазине.
  • Refund Policy и Privacy Policy - укажите ссылки на правила возврата товара и политику конфиденциальности (пользовательское соглашение)
  • Direct Return - вам нужно выбрать Header Redirect (Your URL)
  • Secret Word - укажите секретное слово.
Настройки личного кабинета 2Checkout
Настройки личного кабинета 2Checkout
Настройки личного кабинета 2Checkout Dashboard
Настройки личного кабинета 2Checkout

Сохраните изменения.

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

2Checkout Inline for Phoca Cart устанавливается как обычное расширение Joomla. Удостоверьтесь, что вы скачали последнюю версию плагина, затем перейдите в Панель Администратора > Расширения > Менеджер расширений > Установки, далее выберите установочный пакет, скачанный с сайта NorrNext.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вкладка "Опции метода оплаты"

Настройка опций метода оплаты 2Checkout в Phoca Cart
Опции метода оплаты 2Checkout в Phoca Cart

**Примечание:** Обратите внимание на то, что этот платёжный метод не поддерживает настройку округления общей суммы до 0 и 1 знака после запятой!

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

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

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

Настройки живого окружения

  • ID продавца - укажите ваш ID продавца (Seller ID) в 2Checkout.
  • Секретное слово - Укажите ваше секретное слово (Secret Word). Вы можете найти его на вкладке Site Management панели управления 2Checkout.

Настройки тестового окружения

  • ID продавца - укажите ваш ID продавца (Seller ID) в 2Checkout. ID нужно взять отсюда: 2Checkout sandbox account. Не забудьте включить режим Sandbox.

В тестовых целях вы можете использовать площадку 2Checkout sandbox и включить логирование в настройках Phoca Cart (Разрешить ведение журнала), что позволит сохранять всю полезную информацию о проведённых платежах в системном .log файле Joomla.

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

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

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

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

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

2Checkout Inline Payment plugin for Phoca Cart - ключ для скачивания
Вкладка "Ключ для скачивания"

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

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

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

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

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

Поддерживает ли 2Checkout приём платежей через PayPal?
Да. Если у клиента совпадает e-mail, указанный при регистрации с аккаунтом в системе PayPal, на странице оплаты появится специальная кнопка PayPal.

Можно ли использовать стандартный режим 2Checkout (standard mode)?
Нет. Данный плагин обрабатывает платежи только в режиме Inline.

Что означает ERROR CODE:PE101?
В редких случаях у пользователей на этапе оплаты может появиться такая ошибка. Это означает, что банк по каким-то причинам отклонил платёж. В такой ситуации пользователю стоит попробовать совершить повторный платёж через некоторое время или воспользоваться картой, эмитированной другим банком.