Плагины электронной коммерции
Расширение OpenCart
Установите и настройте официальное расширение OpenCart с собственным OAuth, размещенным на хосте checkout MakePay и подписанным webhooks.
Обзор
MakePay для OpenCart позволяет продавцам принимать криптовалютные платежи с помощью MakePay, размещенного на checkout, без сбора платежных данных в OpenCart. Расширение отображается как способ оплаты OpenCart, создает ссылку для оплаты MakePay для каждого заказа, перенаправляет покупателя на MakePay и принимает подписанный webhooks для обновления статуса заказа в OpenCart.
Прежде чем начать
- ОпенКарт 4.х
- PHP 8.0 или выше
- HTTPS во внешнем интерфейсе магазина
- Компания MakeCrypto с включенным MakePay.
- Пользователь MakeCrypto, который может подключить принимающую компанию.
- Опционально: интеграция API MakePay для резервного копирования с помощью ручного ключа API
OpenCart сохраняет настройки расширения в своей базе данных. Ограничивает доступ к администратору OpenCart доверенным операторам, поскольку сведения о подключении, секреты webhook и дополнительные резервные учетные данные сохраняются в настройках расширения платежа.
Настроить MakeCrypto
Завершите настройку merchant перед подключением OpenCart.
- Откройте Главная страница > Продавец > Настройки платежей и убедитесь, что MakePay включен.
- Откройте Главная > Интеграции > Интеграции API.
- Убедитесь, что пользователь, подключающийся к OpenCart, может управлять интеграциями для этой компании.
- Необязательный резервный вариант: создайте или выберите интеграцию API и скопируйте идентификатор компании, идентификатор ключа API и секрет.
Установите расширение
Рекомендуемый источник — официальный листинг на OpenCart Marketplace:
Открыть в обозревателе расширений OpenCart
Для ручной установки загрузите последнюю версию пакета OpenCart напрямую:
Скачать инструкцию OCMOD в формате ZIP
Затем установите его в OpenCart:
- В администраторе OpenCart откройте Расширения > Установщик.
- Загрузите
makepay.ocmod.zip. - Откройте Расширения > Расширения и выберите Платежи.
- Найдите MakePay и нажмите «Установить».
- Откройте Изменить, чтобы настроить способ оплаты.
Корень пакета содержит install.json, admin/ и catalog/, соответствующие формату установщика расширений OpenCart 4.
Подключите MakePay
В разделе Расширения > Платежи > MakePay используйте Подключить MakePay. Расширение:
- Откройте MakeCrypto на вкладке браузера.
- Вам предлагается войти в систему и выбрать компанию, которая будет получать платежи.
- Показывает разрешения, необходимые расширению OpenCart.
- Возвращает вас в OpenCart после прохождения.
- Сохраните подключение к магазину и идентификатор компании.
- Настраивает обратный вызов URL для webhook MakePay и секрет webhook.
Соединение запрашивает следующие разрешения:
company:read
makepay:payment-links:read
makepay:payment-links:write
makepay:customers:read
makepay:customers:write
makepay:settings:read
makepay:settings:write
URI перенаправления имеет следующую форму:
https://your-store.example/index.php?route=extension/makepay/payment/makepay.oauth
Настроить MakePay
В разделе Расширения > Платежи > MakePay настройте:
| Поле | Ценность |
|---|---|
| Статус | Включено |
| Название способа оплаты | Этикетка checkout видна покупателю |
| Способы подключения | Подключите MakePay или резервный вариант с помощью ручного ключа API. |
| MakePay Идентификатор компании | Заполняется после подключения или вводится вручную для отката |
| Идентификатор ключа API | Идентификатор интеграции API только для резервного варианта |
| Секретный ключ API | Секрет интеграции API только для резервного варианта. |
| Webhook секрет | Настраивается во время подключения или вводится вручную для резервного копирования. |
| База API URL | https://www.makecrypto.io |
| Валюта расчета | Актив расчета по умолчанию, например USDT. |
| Срок действия платежной ссылки истек | Например 12h |
| Опыт оформления заказа | Размещенное перенаправление или встроенный checkout с безопасным iframe и размещенным резервным вариантом. |
Имя метода оплаты по умолчанию:
Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others
Настроить webhooks
Скопируйте URL из webhook, показанного на странице настроек MakePay OpenCart. Он имеет такую форму:
https://your-store.example/index.php?route=extension/makepay/payment/makepay.webhook
Connect MakePay автоматически настраивает этот обратный вызов. Для возврата к ручному ключу API добавьте его в настройки webhook MakePay с тем же секретным ключом webhook, введенным в OpenCart.
Расширение проверяет X-MakePay-Signature перед обновлением заказа. В подписи используется формат HMAC с отметкой времени:
t=1760000000,v1=<hex-hmac>
Поток checkout
Когда покупатель выбирает MakePay:
- OpenCart проверяет активный заказ и выбранный способ оплаты.
- Расширение вызывает API partner из MakePay для создания платежной ссылки.
- Ордер переходит в настроенный статус ожидания.
- Покупатель открывает выбранный опыт checkout MakePay.
- Подписанный webhook обновляет заказ OpenCart после изменения статуса платежа.
Ссылка для оплаты включает metadata:
| Метаданные | Цель |
|---|---|
source=opencart | Определить интеграцию |
orderId | Идентификатор заказа OpenCart |
storeId | Идентификатор магазина OpenCart |
storeName | Название магазина |
storeUrl | URL из интерфейса магазина |
opencartOrderId | Идентификатор заказа OpenCart для информационной панели и webhooks |
opencartOrderAdminUrl | Администратор URL, используемый действием MakeCrypto Показать заказ |
storeOrderAdminUrl | Администратор заказа URL Общий резервный вариант |
moduleVersion | MakePay Версия расширения OpenCart |
opencartVersion | Версия OpenCart во время выполнения |
Статусы заказов
Настройте отображение состояний в настройках расширения.
| Статус MakePay | Статус OpenCart |
|---|---|
paid, completed, confirmed, succeeded | Платный статус |
failed, expired, chargeback | неудавшееся состояние |
cancelled, canceled | Статус отменен |
refunded | Статус возврата |
| Любой статус в процессе | Статус ожидания |
Расширение добавляет комментарий истории заказов со статусом MakePay, UID или идентификатором платежа, суммой, активом и URL из checkout, размещенным, если он присутствует в payload из webhook. Первоначальная запись истории checkout также включает общедоступную проверку URL и ссылку на панель мониторинга MakeCrypto, если она предоставлена ответом API.
Примечания по безопасности
- Используйте HTTPS для URL-адресов checkout и webhook.
- Ограничивает доступ администратору OpenCart, поскольку сведения о подключении и дополнительные учетные данные сохраняются в настройках OpenCart.
- Отзовите подключенное приложение OpenCart из MakeCrypto, если учетная запись администратора OpenCart скомпрометирована.
- Поменяйте ключ API MakePay, если предоставлены резервные учетные данные вручную.
- Храните секрет webhook отдельно от секрета ключа API.
- Устраняет непредвиденные сбои подписи webhook как возможное несоответствие учетных данных или попытку подмены.
Устранение неполадок
Если способ оплаты не отображается, убедитесь, что MakePay включен, что общая сумма корзины соответствует настроенному минимуму и что адрес клиента соответствует настроенной географической зоне.
Если Подключить MakePay не удалось, убедитесь, что магазин OpenCart URL использует HTTPS, и браузер возвращается к обратному вызову URL, показанному выше.
Если checkout не выполняет перенаправление, убедитесь, что хранилище подключено. Для возврата вручную подтвердите идентификатор компании, идентификатор ключа API, секретный ключ ключа API, базовый URL API и разрешения на интеграцию MakePay.
Если заказы не обновляются после оплаты, подтвердите, что URL в webhook является общедоступным через HTTPS и что секрет webhook в MakePay соответствует секрету, хранящемуся в OpenCart.
Если OpenCart сообщает об ошибке установщика, убедитесь, что загруженный файл заканчивается на .ocmod.zip и содержит install.json, admin/ и catalog/ в корне ZIP-архива.