Модуль MakePay для Magento

Обзор

Официальный модуль MakePay для Magento добавляет размещенный криптографический метод checkout в магазины Magento Open Source и Adobe Commerce 2.4.x. Magento создает заказ, MakePay создает ссылку размещенного платежа, а подписанный webhooks обновляет заказ при изменении статуса платежа.

Используйте Connect MakePay для нормальной конфигурации. Учетные данные вручную с ключом API по-прежнему доступны в качестве резервного варианта.

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

• Magento с открытым исходным кодом или Adobe Commerce 2.4.x
• PHP 8.1 или выше
• Доступ администратора к Магазинам > Конфигурация > Продажи > Способы оплаты.
• Компания MakePay, где вы можете управлять корректировкой платежей.

Установите модуль

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

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

Распакуйте пакет так, чтобы модуль находился в:

app/code/MakePay/Payment

Включите его из корня Magento:

bin/magento module:enable MakePay_Payment
bin/magento setup:upgrade
bin/magento cache:clean

Подключите MakePay

Откройте «Магазины» > «Конфигурация» > «Продажи» > «Способы оплаты» > MakePay и выберите «Подключить MakePay». Модуль:

1. Откройте MakeCrypto на вкладке браузера.
2. Вам предлагается войти в систему и выбрать компанию, которая будет получать платежи.
3. Показывает разрешения, необходимые модулю Magento.
4. Возвращает вас в Magento после одобрения.
5. Сохраните соединение с магазином в зашифрованной конфигурации Magento.
6. Настраивает обратный вызов webhook MakePay и секрет webhook.

Настроить MakePay

После подключения метод подключения сохраняется в режиме подключения по умолчанию. Включите способ оплаты и проверьте:

• Название способа оплаты
• Опыт оформления заказа
• Валюта расчета
• Срок действия платежной ссылки истек
• Статусы заказов: ожидающий, оплаченный, не выполненный, отмененный и возвращенный.

Для возврата вручную требуется идентификатор компании MakePay, идентификатор ключа API, секретный ключ API и секретный ключ webhook.

Поток checkout

Когда клиент выбирает MakePay, Magento помещает заказ в режим ожидания оплаты, а затем открывает выбранный опыт checkout MakePay. Хостинговое перенаправление является рекомендуемым вариантом; Встроенный checkout отображает защищенную страницу с iframe MakePay и размещенную резервную ссылку.

Платежная ссылка payload включает в себя:

Поле	Цель
source=magento	Определить интеграцию
orderId=magento_order_<id>	Сопоставьте активность MakePay обратно с Magento
incrementId	Читаемый номер заказа Magento
magentoOrderAdminUrl	Позволяет MakeCrypto связать администраторов с заказом Magento.
moduleVersion	Установленная версия модуля MakePay
magentoVersion	Рабочая версия Magento или Adobe Commerce

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

Конечная точка webhook — /makepay/webhook/index. Прежде чем обновлять заказ, проверьте заголовок X-MakePay-Signature.

Статус MakePay	Статус Magento
paid, completed, confirmed, succeeded	Обработка
failed, expired	Отменено
cancelled, canceled	Отменено
refunded	Закрыто
Другие штаты	Ожидает платежа

Каждый webhook записывает частный комментарий к истории заказов со статусом платежа, общедоступными URL checkout MakePay, информационной панелью URL MakeCrypto и доступными идентификаторами MakePay.

Примечания по безопасности

Модуль сохраняет данные подключения в зашифрованных настройках Magento. Ограничьте доступ администратора Magento доверенным операторам и отключите магазин по адресу MakeCrypto, если будет открыта учетная запись администратора или резервная копия сервера.

Соединение запрашивает следующие разрешения:

• company:read
• makepay:payment-links:read
• makepay:payment-links:write
• makepay:customers:read
• makepay:customers:write
• makepay:settings:read
• makepay:settings:write

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

Если Connect MakePay не запускается, убедитесь, что база Magento URL является HTTPS и общедоступна. Если перенаправление checkout завершается неудачно, убедитесь, что модуль включен и что у MakePay есть сохраненное соединение или действительные учетные данные, введенные вручную. Если заказы не обновляются, сравните обратный вызов URL для webhook в настройках MakePay с URL Magento /makepay/webhook/index и поменяйте секрет webhook.