MakePay Шлюз для ClientExec

Обзор

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

Регулярное выставление счетов остается в ClientExec. Когда ClientExec создает каждый счет за продление, тот же поток шлюза MakePay позволяет клиенту оплатить этот счет.

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

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

• ClientExec 6.8 или выше, включая ClientExec 7.x
• PHP 7.4 или выше с включенными OpenSSL и cURL
• URL HTTPS от ClientExec
• Доступ администратора ClientExec к платежным системам
• Компания MakePay, где вы можете управлять корректировкой платежей.

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

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

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

Распакуйте ZIP-архив и загрузите папку makepay в:

ClientExec/plugins/gateways/makepay

Пакет устанавливает следующие файлы:

plugins/gateways/makepay/PluginMakepay.php
plugins/gateways/makepay/PluginMakepayCallback.php
plugins/gateways/makepay/callback.php
plugins/gateways/makepay/oauth.php
plugins/gateways/makepay/lib/*.php

В ClientExec откройте «Настройки» > «Плагины» > «Платежные системы», выберите MakePay и сохраните настройки платежной системы.

Подключите MakePay

Откройте настройки процессора MakePay и скопируйте Connect MakePay URL в свой браузер. Шлюз:

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

Настроить MakePay

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

• Идентификатор компании MakePay
• Ликвидационный актив
• Срок действия платежа
• Секрет подписи webhook
• Регистрационное имя, отображаемое клиентам

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

Поток checkout

Когда клиент оплачивает неоплаченный счет ClientExec с помощью MakePay, шлюз создает размещенную ссылку для оплаты и перенаправляет клиента на checkout MakePay.

Поле	Цель
source=clientexec	Определить интеграцию
orderId=clientexec_invoice_<invoiceId>	Сопоставляет активность MakePay обратно с ClientExec
invoiceId	Номер счета ClientExec
clientId	Идентификатор клиента ClientExec, если доступен
moduleVersion	Установленная версия шлюза MakePay.
clientexecVersion	Версия среды выполнения ClientExec, если она доступна.

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

Регулярные счета

ClientExec продолжает нести ответственность за повторяющиеся продукты, даты продления, налоги, создание счетов и электронную почту клиентов. MakePay не создает отдельный календарь подписки в версии 1.

Для каждого повторяющегося счета, создаваемого ClientExec, шлюз MakePay ведет себя так же, как и для одного счета: он создает размещенную ссылку checkout и ожидает подписанного обратного вызова, прежде чем пометить счет как оплаченный.

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

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

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

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

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

Шлюз сохраняет сведения о соединении в установке ClientExec. Ограничьте доступ администратора доверенным операторам и отключите шлюз от информационной панели MakePay, если доступна учетная запись администратора или резервная копия сервера.

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

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

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

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