MakePay Поставщик платежей для XenForo

Обзор

Официальное дополнение MakePay для XenForo добавляет размещенную криптовалюту checkout в платные профили XenForo. XenForo создает запрос на покупку, MakePay создает размещенную ссылку для оплаты, а обработчик обратного вызова платежа XenForo завершает покупку после подписанного webhook MakePay.

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

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

• XenForo 2.3 или выше
• PHP 8.1 или выше с включенным OpenSSL
• URL Форум/Сообщество HTTPS
• Доступ администратора к платежным профилям
• Компания MakePay, где вы можете управлять корректировкой платежей.

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

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

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

Установите его с помощью установщика дополнительных файлов XenForo или загрузите содержимое каталога upload/ в корень XenForo. Идентификатор дополнения — MakePay/Payment, а исходный код установлен по адресу:

src/addons/MakePay/Payment

Подключите MakePay

Откройте «Параметры» > «Поставщики услуг» > «Профили платежей» > «Добавить профиль оплаты» и выберите MakePay. Сохраните профиль один раз, снова откройте его и выберите «Подключить MakePay». Дополнение:

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

Настроить MakePay

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

• Идентификатор компании MakePay
• Валюта расчета
• Срок действия платежной ссылки истек
• webhook обратный вызов URL
• Резервные учетные данные с помощью ручного ключа API

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

Поток checkout

Добавьте платный профиль MakePay в обновление пользователя XenForo, платный ресурс или другой приобретаемый поток, который поддерживает платные профили. Когда участник выбирает MakePay, надстройка создает платежную ссылку MakePay с metadata XenForo.

Поле	Цель
source=xenforo	Определить интеграцию
orderId=xenforo_purchase_<requestKey>	Сопоставляет активность MakePay с XenForo
requestKey	Ключ запроса на покупку XenForo
purchasableTypeId	XenForo Доступный тип
moduleVersion	Установленная версия дополнения MakePay
xenforoVersion	Версия среды выполнения XenForo

Покупатель перенаправляется на размещенный checkout и возвращается в XenForo после оплаты или отмены.

Статусы платежей

MakePay отправляет подписанные обратные вызовы по адресу:

https://your-forum.example/payment_callback.php?_xfProvider=makepay

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

XenForo записывает журнал поставщика платежей с платежом UID MakePay, ключом запроса на покупку, платежом URL, если он доступен, и обратным вызовом payload.

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

Дополнение сохраняет данные о подключении в настройках платежного профиля. Ограничьте доступ администратора XenForo доверенным операторам и отключите сообщество на 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 не запускается, убедитесь, что форум XenForo URL работает по протоколу HTTPS и является общедоступным. Если кнопка «Подключиться» MakePay отсутствует, сохраните платежный профиль один раз и откройте его снова. Если покупки не завершились, сравните webhook MakePay обратного вызова URL с XenForo URL payment_callback.php?_xfProvider=makepay и поменяйте секрет webhook.