MakePay Шлюз для WHMCS

Обзор

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

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

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

• WHMCS 8.13 LTS или WHMCS 9.x
• PHP 8.1 или выше с включенным OpenSSL
• Система WHMCS URL через HTTPS
• Доступ администратора WHMCS к платежным шлюзам
• Компания MakePay, где вы можете управлять корректировкой платежей.

Установить шлюз

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

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

Распакуйте ZIP-архив и загрузите каталог modules в корень WHMCS. Пакет устанавливает следующие файлы:

modules/gateways/makepay.php
modules/gateways/makepay/checkout.php
modules/gateways/makepay/oauth.php
modules/gateways/makepay/lib/*.php
modules/gateways/callback/makepay.php

В WHMCS откройте «Настройки системы» > «Платежные шлюзы», включите MakePay и сохраните настройки шлюза.

Подключите MakePay

Откройте настройки шлюза MakePay и выберите «Подключить MakePay». Шлюз:

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

Настроить MakePay

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

• Идентификатор компании MakePay
• Ликвидационный актив
• Срок действия платежа
• Статус подключения MakePay
• Секрет подписи webhook

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

Поток checkout

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

Поле	Цель
source=whmcs	Определить интеграцию
orderId=whmcs_invoice_<invoiceId>	Сопоставляет активность MakePay обратно с WHMCS.
invoiceId	Идентификатор счета-фактуры WHMCS
clientId	Идентификатор клиента WHMCS
moduleVersion	Установленная версия шлюза MakePay.
whmcsVersion	Версия среды выполнения WHMCS

Покупатель возвращается к исходному счету-фактуре WHMCS после оплаты или отмены.

Статусы счетов

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

https://billing.example.com/modules/gateways/callback/makepay.php

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

Журналы транзакций WHMCS включают обратный вызов payload MakePay, поэтому группы поддержки могут отслеживать платеж UID, счет-фактуру metadata, сумму и статус.

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

Шлюз сохраняет сведения о подключении в настройках шлюза WHMCS. Ограничьте доступ администратора WHMCS доверенным операторам и отключите шлюз на 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 не запускается, убедитесь, что система WHMCS URL использует протокол HTTPS и соответствует общедоступному домену выставления счетов. Если клиенты видят ошибку checkout, убедитесь, что шлюз активен, счет не оплачен и идентификатор компании MakePay сохранен. Если обратные вызовы не помечают счета как оплаченные, сравните URL из обратного вызова MakePay с URL из предыдущего обратного вызова WHMCS и поменяйте секрет webhook из настроек шлюза.