Назначение группы плагинов

Плагины платежей служат для интеграции систем приёма электронных платежей с компонентом JoomlaKassa. Группа (тип) плагинов платежей – jkpaysystem, эта группа предназначена только для компонента JoomlaKassa.

Плагин платежей позволяет:

  • добавить имя платёжной системы в список выбора системы по умолчанию (Конфигурация компонента Корзина | Заказ Система по умолчанию);
    service_payment-admin
  • добавить имя, логотип и описание платёжной системы, на странице заказа, в список выбора системы, через которую будет проводиться оплата заказа в магазине;
    service_payment-site
  • сгенерировать форму для передачи данных обработчику заказа;
  • отобразить содержимое на странице тестирования информации, передаваемой платёжной системе;
  • проверить достоверность данных платежа и перенаправить покупателя в зависимости от результата платежа.
Внимание! Для использования плагинов платежей необходима регистрация на сайте выбранной платёжной системы.

JoomlaKassa PaySystem - Interkassa

ik_logo

Плагин позволяет подключить систему приёма платежей Interkassa к компоненту JoomlaKassa.

Система приема платежей Interkassa представляет собой универсальный аппаратно-программный комплекс, посредством которого, осуществляется обработка операций от основных платежных интернет-систем. Interkassa – это удобный в использовании сервис, подключение к которому позволит Интернет-магазинам, веб-сайтам и прочим торговым площадкам принимать все возможные формы оплаты в максимально короткие сроки.

Внимание! Для использования плагина требуется регистрация в системе Interkassa.
Примечание. Перед началом использования плагина он должен быть установлен в вашей системе Joomla!

Алгоритм выполнения платежа

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

Алгоритм выполнения платежа в системе Interkassa представлен на рисунке ниже.

ik_shema

Checkout Page — Страница, на которой отображается HTML-форма запроса платежа.

Paysystems List — Страница с доступными для данной кассы платежными системами, через которые клиент может совершить оплату. Пример:

ik_paysystems_list

Payway List — Страница выбора способа оплаты.

ik_payway_list

Create Invoice — Скрипт создания счета на оплату и перенаправления клиента на платежный шлюз.

Payment Gateway — Платежный шлюз, через который клиент совершает оплату.

Payment Processing — Скрипт проведения платежа на платежном шлюзе. При проведении платежа, уведомляет сервер SCI (Interaction Page) о результате проведения. В свою очередь, SCI уведомляет Interaction Page на сервере мерчанта с информацией по счету и проведении платежа.

Payment Result Page — Страница результата проведения платежа, с которой клиент перенаправляется на SCI.

Result Page — Страница SCI, на которую попадает клиент после оплаты, ожидает получения SCI результата проведения платежа платежным шлюзом, и в зависимости от этого перенаправляется на страницу Успешного проведения платежа (Success Page), Неуспешного (Fail Page) или Незавершенного (Pending Page) соответственно.

ik_result_page


Основные параметры плагина

Чтобы получить доступ к параметрам плагина: откройте Менеджер плагинов, выберите тип плагина "jkpaysystem" (см. Доступ к плагинам) и нажмите на название плагина "JoomlaKassa PaySystem - Interkassa".

ik_admin-1

  1. ID магазина.
    В этом поле указывается идентификатор магазина зарегистрированного в системе Interkassa. Узнать его можно в разделе "Мои кассы" на сайте системы платежа.
    Пример: 64C18529-4B94-0B5D-7405-F2752F2B716C
  2. Секретный ключ.
    Это строка символов, добавляемая к реквизитам платежа, высылаемым продавцу вместе с оповещением. Секретный ключ предназначен для проверки и формирования подписи данных, используется для повышения надежности идентификации высылаемого оповещения. Содержание строки известно только сервису IK и продавцу!
    Секретный ключ хранить обязательно в строгой секретности!
    Секретный ключ можно в разделе "Настройки кассы" на сайте системы платежа.
    Пример: Nh4yS7d6EAfHWvLJ
  3. Валюта платежа.
    Выбранная здесь валюта должна соответствовать настройкам кассы на сайте системы платежа. Также валюта должна быть создана и опубликована в разделе "Менеджер валют" компонента JKassa.
  4. Тестовый режим.
    Этот параметр предназначен для тестирования настроек системы платежа.
    1. Тестовый режим компонента.
      При включении плагина в этот режим, ссылки, ведущие на страницу системы оплаты Interkassa, будут изменены на ссылки, которые ведут на тестовую страницу компонента. На этой странице будет отображена вся информация передаваемая сервису оплаты. Также на этой странице расположены кнопки для тестирования ответов от этой системы.
    2. Тестовый режим Interkassa.
      При проведении платежа через "Тестовую платежную систему Interkassa", транзакция не совершается! Меняется только состояние выставленного Вами счета, без зачисления суммы платежа на Ваш баланс. Подробней, смотрите ниже.
  5. Тестовый ключ.
    Используется при формировании цифровой подписи, если платеж был совершен через тестовую платежную систему Interkassa.

Дополнительные параметры

ik_admin-2

Дополнительные параметры для плагина. Без необходимости не изменяйте их.

Примечание. Чтобы получить помощь по стандартным настройкам плагина Joomla!, воспользуйтесь кнопкой "Справка", которая расположена на панели инструментов плагина search_btn.

Настройки кассы

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

После создания "Кассы", для успешного совершения платежа сгенерированного компонентом и отправленного для последующей обработки в систему "Интеркасса" в плагине и в системе должны быть установлены определённые настройки. Они позволяют задать значения по умолчанию, логику работы шлюза и веб-интерфейса, настройки безопасности, доступные способы оплаты и др.

Для настройки кассы авторизуйтесь на сайте системы, выберите "Режим касс (Мои кассы)", выберите нужную кассу и нажмите значок настроек кассы.

ik_checkout

В настройках кассы перейдите на вкладку "Настройки платежей" и установите обязательные параметры.

ik_checkout_paysystems
  1. Использовать протокол v2.0.
    Этот параметр обязательно должен быть включен.
  2. Валюта кассы.
    Выбранная здесь валюта должна соответствовать настройкам валюты в плагине JKPaySystem – Interkassa. Также валюта должна быть создана и опубликована в разделе "Менеджер валют" компонента JKassa.
  3. Проверять уникальность платежей.
    Данная опция позволяет производить проверку перед созданием нового платежа на уникальность по его номеру. И в случае, если платеж с таким же номером найден, в биллинге кассы клиенту выдается соответствующая ошибка.

На вкладке "Интерфейс", для каждого из URL взаимодействия должны быть установлены следующие параметры:

ik_checkout_interface
  • Тип запроса: POST;
  • Разрешить переопределять в запросе: ВКЛ.

Перейдите на вкладку "Безопасность". Установите и получите на ней требуемые параметры.

ik_checkout_security
  1. Алгоритм подписи.
    Используется SCI при формировании цифровой подписи.
    Обязательно должно быть установлено значение MD5.
  2. Проверять подпись в форме запроса платежа.
    Этот параметр должен быть отключен, иначе вы получите ошибку при запросе платежа к системе.
  3. Секретный ключ.
    Используется SCI при формировании цифровой подписи.
    Ключ необходимо создать, скопировать и вставить в соответствующее поле в настройках плагина JKPaySystem – Interkassa.
  4. Тестовый ключ.
    Используется SCI при формировании цифровой подписи, если платеж был совершен через тестовую платежную систему.
    Ключ необходимо создать, скопировать и вставить в соответствующее поле в настройках плагина JKPaySystem – Interkassa.
Примечание. Обязательные параметры, которые необходимо установить, отмечены на снимках экрана, остальные параметры устанавливаются на ваше усмотрение.

После сохранения изменений, интеграция с системой платежа Interkassa и вашим магазином – настроена.


Тестовый режим компонента

При включении плагина в этот режим, ссылки, ведущие на страницу системы оплаты Interkassa, будут изменены на ссылки, которые ведут на тестовую страницу компонента. На этой странице будет отображена вся информация передаваемая сервису оплаты. Также на этой странице расположены кнопки для тестирования ответов от этой системы:

ik_test_mode-component
  1. Interaction Page.
    Позволяет выбрать ответ от системы: новый, ожидает оплаты, обрабатывается, успешно проведен, отменен, не проведен, просрочен.
    В зависимости от выбора ответа, при нажатии на определённую кнопку, вы будете перенаправлены на соответствующую страницу.
  2. Pending Page.
    Кнопка, при нажатии на которую вы попадёте на страницу ожидания обработки заказа. Обратите внимание, если вы выберите ответ от системы платежа: успешно проведен, то при нажатии на эту кнопку вы будете перенаправлены на страницу успеха. Или если вы выберите ответ от системы платежа: отменен, не проведен, просрочен, то вы будете перенаправлены на страницу ошибки.
  3. Success Page.
    Кнопка, при нажатии на которую вы попадёте на страницу успешного платежа, но только в том случае, если от системы платежа был получен положительный ответ.
  4. Fail Page.
    Кнопка, которая ведёт только на страницу ошибки, при любом из ответов от системы платежа.

Тестовый режим Interkassa

Для тестирования процесса оплаты и проведения платежа существует "Тестовая платежная система". Она отключена по умолчанию, как возможный способ оплаты в Вашей кассе. Для включения данной платежной системы перейдите в Настройки кассы -› Платежные системы и включите "Тестовая платежная система".

Внимание! Если Ваша касса настроена и работает в публичном открытом режиме, Вам необходимо отключить в настройках кассы "Тестовую платежную систему".

Для совершения тестовой оплаты, Вам, достаточно только, выбрать ее в качестве системы для оплаты, выбрать в плагине параметр "Тестовый режим Interkassa" и нажать кнопку "Оплатить". После чего, SCI перенаправит Вас на соответствующую страницу возврата на Вашем сайте.

Внимание! При проведении платежа через "Тестовую платежную систему", транзакция не совершается! Меняется только состояние выставленного Вами счета, без зачисления суммы платежа на Ваш баланс.

Таким образом, Вы сможете протестировать, в полной мере, весь процесс оплаты, а также обработку уведомления о платеже (Interaction Form) на Вашей кассе. Для этого, используйте "тестовый секретный ключ", который доступен Вам в настройках кассы. Данный ключ используется для подписи уведомления о платеже только через "тестовую платежную систему".

Внимание! Данный механизм, с "тестовым секретным ключом", предотвращает ситуацию, когда Ваше веб-приложение может зачислить платеж, проведенный через "тестовую платежную систему", по данным, переданным на страницу взаимодействия (Interaction URL). Для этого, ВСЕГДА проверяйте цифровую подпись от SCI.

JoomlaKassa PaySystem - WebMoney

wm_logo

Плагин позволяет подключить систему приёма платежей WebMoney к компоненту JoomlaKassa.

WebMoney Transfer — международная система расчетов и среда для ведения бизнеса в сети, основана в 1998 году. За это время к системе присоединилось более 28 миллионов человек по всему миру. Web Merchant Interface подходит магазинам, которым требуется собственная форма оплаты и/или автоматизированный учет заказов (в том числе и с выдачей цифровых товаров).

Внимание! Для приема платежей через сервис Web Merchant Interface продавец должен настроить ряд параметров, регулирующих порядок приема платежей и оповещения продавца о факте проведения платежа. Настройка параметров выполняется на странице "Настройки" сайта сервиса — merchant.webmoney.ru.
Примечание. Перед началом использования плагина он должен быть установлен в вашей системе Joomla!

Чтобы получить доступ к параметрам плагина: откройте Менеджер плагинов, выберите тип плагина "jkpaysystem" (см. Доступ к плагинам) и нажмите на название плагина "JoomlaKassa PaySystem - WebMoney".

Алгоритм выполнения платежа

Алгоритм выполнения платежа представлен на рисунке ниже.

wm_admin-1

Основные параметры плагина

wm_admin-1

  1. Наименование магазина.
    Текст, который будет показан покупателю на странице выполненного или невыполненного платежа в стоке "Магазин".
  2. Кошельки продавца.
    Допускаемые кошельки, на которые покупатель должен совершить платёж. Платёж будет зачислен на кошелёк, который соответствует выбранной валюте в магазине. Формат - 12 цифр.
  3. Секретный ключ.
    Строка символов (до 50 символов (с учетом регистра)), добавляемая к реквизитам платежа, высылаемым продавцу вместе с оповещением. Эта строка используется для повышения надежности идентификации высылаемого оповещения. Содержание строки известно только сервису Web Merchant Interface и продавцу! Заполняется на странице настроек сайта сервиса — merchant.webmoney.ru.
    Внимание! Используйте одинаковый секретный ключ для всех указанных кошельков продавца.
  4. Тестовый режим.
    При переключении плагина в тестовый режим компонента, покупатель будет перенаправлен на тестовую страницу обработки платежа JoomlaKassa, где показана вся информация передаваемая системе оплаты.
    При переключении плагина в тестовый режим WebMoney, сервис будет имитировать оплату в Web Merchant Interface:
    1. Режим WebMoney – 1.
      Для всех тестовых платежей сервис будет имитировать успешное выполнение.
    2. Режим WebMoney – 2.
      Для всех тестовых платежей сервис будет имитировать выполнение с ошибкой (платеж не выполнен).
    3. Режим WebMoney – 3.
      Около 80% запросов на платеж будут выполнены успешно, а 20% - не выполнены.
Внимание! При включении плагина в тестовый режим WebMoney, для каждого кошелька, на который продавец принимает платежи, должен быть включен тестовый режим в настройках сайта сервиса — merchant.webmoney.ru.

Дополнительные параметры

wm_admin-2

Дополнительные параметры для плагина. Без необходимости не изменяйте их.

Примечание. Чтобы получить помощь по стандартным настройкам плагина Joomla!, воспользуйтесь кнопкой "Справка", которая расположена на панели инструментов плагина search_btn.

Настройки кошелька

Для обеспечения приема WebMoney на своем веб-сайте вы должны настроить сервис Web Merchant Interface для обработки платежей, выполняемых покупателем на ваш кошелек.

На сайте сервиса Merchant WebMoney Transfer выберите пункт меню Настройки. Пройдите авторизацию и выберите кошелек, на который вы будете принимать платежи.

Вы получите страницу для настройки своих кошельков.

wm_settings

Ниже приведен перечень значений и параметров:

  1. Номер кошелька в системе WebMoney Transfer.
    Скопируйте номер вашего кошелька (только 12 цифр, без префикса) и вставьте его в соответствующее поле в настройках плагина.
  2. Тестовый/Рабочий режимы.
    Определяет режим обработки платежей в сервисе. В тестовом режиме Web Merchant Interface имитирует выполнение платежей (реально платежи не выполняются). В тестовом режиме возможна оплата только через WM Keeper.
  3. Торговое имя.
    Это название отображается на странице при оплате.
  4. Secret Key.
    Строка символов, добавляемая к реквизитам платежа, высылаемым продавцу вместе с оповещением. Эта строка используется для повышения надежности идентификации высылаемого оповещения. Содержание строки известно только сервису Web Merchant Interface и продавцу!
    Скопируйте эту строку и вставьте в соответствующее поле в настройках плагина.
  5. Высылать на Result URL, если обеспечивается секретность (оставьте поле пустым).
  6. Secret Key X20 (оставьте поле пустым).
  7. Result URL (оставьте поле пустым).
  8. Передавать параметры в предварительном запросе (оставьте поле пустым).
  9. Proxy для Result URL.
    В случае если из-за каких-либо страновых, регулирующих и прочих ограничений Result URL недоступен со стандартных IP, можно использовать указанные в списке. Вызов Result URL будет приходить с указанного IP.
  10. Success URL (оставьте поле пустым).
  11. Fail URL (оставьте поле пустым).
  12. Позволять использовать URL, передаваемые в форме.
    Обязательно установите этот флаг! Флаг, оповещающий Web Merchant Interface о том, что Result URL, Success URL, метод вызова Success URL, Fail URL и метод вызова Fail URL могут быть изменены в "Payment Request Form".
  13. Высылать оповещение об ошибке платежа на кипер.
    Флаг, оповещающий Web Merchant Interface о том, что в случае возникновения ошибки при выполнении платежа необходимо послать оповещение на кипер продавца.
  14. Метод формирования контрольной подписи.
    Обязательно выберите алгоритм "SHA256". Алгоритм, который Web Merchant Interface использует для контроля подлинности оповещения, высылаемого на сайт продавца при выполнении платежа через сервис.
  15. Обязательно требовать подтверждение транзакции по СМС.
  16. Дополнительные методы оплаты.
    Параметры позволяющие настроить дополнительные методы оплаты.
  17. Сохранить.
    Не забудьте сохранить сделанные изменения.

JoomlaKassa PaySystem - Яндекс.Деньги

ym_logo

Плагин позволяет подключить систему приёма платежей Яндекс.Деньги к компоненту JoomlaKassa. Начните получать деньги прямо сейчас — от любых пользователей рунета. Переводы будут мгновенно зачисляться на ваш счет в Яндекс.Деньгах.

Внимание! Для использования плагина требуется регистрация в системе Яндекс.
Примечание. Перед началом использования плагина он должен быть установлен в вашей системе Joomla!

Чтобы получить доступ к параметрам плагина: откройте Менеджер плагинов, выберите тип плагина "jkpaysystem" (см. Доступ к плагинам) и нажмите на название плагина "JoomlaKassa PaySystem - Яндекс.Деньги".

Основные параметры плагина

ym_admin-1

  1. Номер счета.
    Номер счета в Яндекс.Деньгах, на который нужно зачислять деньги отправителей.
  2. Секретное слово.
    Секретное слово для проверки уведомлений используется как разделяемый секрет между Яндекс.Деньгами и приложением (плагином). Благодаря этому подделать уведомление невозможно. Секретное слово можно получить в настройках счета Яндекс.Денег, в разделе Информирование - HTTP-уведомления.
    ym_settings-1
    ym_settings-2
    ym_settings-3
  3. Код валюты.
    Значение нельзя изменить - всегда 643 (рубль РФ согласно ISO 4217).
    В компоненте JoomlaKassa должна быть установлена валюта, с кодом 'RUB'.
  4. Тип транзакции.
    Определяет тип транзакции. Возможные значения: Универсальная форма или Благотворительная форма.
  5. Тип платежа.
    Определяет средство платежа. Возможные значения: со счета Яндекс.Денег; с банковской карты; на выбор покупателя, в последнем случае покупателю будут предложены два первых варианта на выбор
    Из этой суммы вычитается комиссия: 0,5%, при переводе из электронного кошелька; 2%, при переводе с банковской карты.
  6. Назначение платежа.
    Сообщение покупателю, до 150 символов. Сообщение будет показано при оплате заказа и в истории переводов покупателя. Для отображения номера платежа используйте тег: {order_id}.
    Пример:
    Спасибо за покупку. Номер платежа: {order_id}.
  7. HTTP-уведомления.
    HTTP-адрес, на который вы будете получать уведомления об входящих платежах или переводах. Скопируйте и вставьте его в настройках счета Яндекс.Денег, в разделе Информирование - HTTP-уведомления.
    ym_settings-4
    Отметьте флажок "Отправлять уведомления" и нажмите кнопку "Сохранить".
  8. Тестовый режим.
    При переключении плагина в тестовый режим, покупатель будет перенаправлен на тестовую страницу обработки платежа, где показана вся информация передаваемая системе оплаты. Эта страница также содержит кнопки для тестирования ответов от этой системы.

Дополнительные параметры

ym_admin-2

Дополнительные параметры для плагина. Без необходимости не изменяйте их.

Примечание. Чтобы получить помощь по стандартным настройкам плагина Joomla!, воспользуйтесь кнопкой "Справка", которая расположена на панели инструментов плагина search_btn.

JoomlaKassa PaySystem - Яндекс.Касса

Материал в разработке.

jkDocs

Мы в соц сетях

Поиск в документации