Плагин MakePay для VirtueMart

Обзор

Плагин MakePay для VirtueMart добавляет размещенный метод оплаты криптовалютой в магазины Joomla с использованием VirtueMart. Покупатели выбирают MakePay на checkout, оплачивают на странице checkout MakePay и возвращаются в магазин, пока VirtueMart сохраняет запись заказа.

Подписанные уведомления об оплате обновляют заказ VirtueMart после оплаты, поэтому команда магазина может продолжать управлять заказами внутри VirtueMart.

Прежде чем начать

• Joomla с установленной VirtueMart
• PHP 7.4 или выше с включенными OpenSSL и cURL
• URL общедоступный HTTPS с витрины магазина
• Доступ к установке расширений Joomla и способов оплаты VirtueMart.
• Компания MakePay с настроенной ликвидацией и брендингом.

Установите плагин

Загрузите последнюю версию ZIP:

https://plugins.makecrypto.io/downloads/virtuemart/latest.zip

В Joomla откройте Система > Расширения, загрузите ZIP-файл, а затем включите Оплата VM — MakePay Crypto Payment Gateway в диспетчере плагинов.

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

Подключите MakePay

После сохранения способа оплаты откройте логин URL на витрине. Замените PAYMENT_METHOD_ID на идентификатор способа оплаты VirtueMart:

https://store.example.com/index.php?option=com_virtuemart&view=pluginresponse&task=pluginnotification&tmpl=component&makepay_oauth=connect&pm=PAYMENT_METHOD_ID

MakePay попросит вас войти в систему, выбрать компанию, которая будет получать платежи, и одобрить подключение. После одобрения плагин сохраняет соединение с этим способом оплаты VirtueMart и устанавливает обратный вызов URL MakePay.

Конфигурация шлюза

Прежде чем публично активировать способ оплаты, просмотрите эти поля:

Корректирование	Цель
Способ подключения	Используйте Connect MakePay для нормальной конфигурации или ручные ключи API в качестве резервного варианта.
Идентификатор компании MakePay	Заполняется после подключения или вводится вручную для отката
Валюта расчета	Предпочтительный расчетный актив, например USDT.
Срок действия платежа	Как долго размещенная ссылка checkout остается платной?
Секрет webhook	Используется для проверки уведомлений о платежах MakePay
Статусы заказов	VirtueMart сообщает о ожидающих, оплаченных, неудавшихся, истекших, отмененных и возвращенных платежах.

Поток checkout

Когда покупатель выбирает MakePay, плагин создает платежную ссылку MakePay с:

Поле	Цель
source=virtuemart	Определить интеграцию
orderId=virtuemart_order_<id>	Сопоставляет активность MakePay с VirtueMart
orderNumber	Номер заказа VirtueMart указан в merchant.
pluginVersion	Установленная версия плагина MakePay.
virtuemartVersion	Версия среды выполнения VirtueMart, если она доступна.

Покупатель перенаправляется на размещенный checkout. Затем MakePay отправляет подписанное уведомление в конечную точку уведомления подключаемого модуля VirtueMart.

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

Статус MakePay	Поведение VirtueMart
paid, completed, confirmed, succeeded	Перевести заказ в настроенный статус оплачен
expired	Перевести заказ в настроенное состояние с истекшим сроком действия
failed	Перевести заказ в настроенное состояние сбоя
cancelled, canceled	Перевести заказ в настроенное отмененное состояние
refunded	Перевести заказ в настроенный статус возврата
Другие штаты	Они игнорируются до тех пор, пока не придет окончательный статус платежа.

Каждое обновление записывает частный комментарий к заказу с транзакцией MakePay, суммой, активом и платежом URL, если эти поля присутствуют.

Резервный вариант с ручным ключом API

Если поток подключения не может быть использован, установите для Метод подключения значение Вручную резервный ключ API и введите:

• Идентификатор компании MakePay
• Идентификатор ключа API
• Секретный ключ API
• Секрет webhook

Используйте его только при необходимости и ограничьте доступ администратора Joomla доверенным операторам.

Устранение неполадок

Если checkout не может запуститься, убедитесь, что метод оплаты имеет подключение к компании или ручные настройки ключа API. В случае сбоя подключения URL убедитесь, что витрина магазина является общедоступной HTTPS и что значение pm указывает на сохраненный способ оплаты MakePay.

Если заказы не обновляются, сравните обратный вызов URL MakePay с уведомлением URL плагина VirtueMart и поменяйте секрет webhook в настройках способа оплаты.