MakePay Шлюз для WISECP

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

Это полезно для хостинг-провайдеров, команд SaaS, агентств и сервисных компаний, которые уже выставляют счета через WISECP.

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

Вам нужно:

• WISECP 3.1.7 или выше
• Установка WISECP HTTPS
• Доступ администратора к настройкам платежного шлюза WISECP
• Настроен расчет и флаг MakePay.

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

Загрузите последний пакет:

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

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

WISECP/coremio/modules/Payment/MakePay

В WISECP откройте Настройки > Биллинг > Платежные шлюзы, найдите MakePay, включите его и сохраните настройки модуля.

Подключите MakePay

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

Поток подключения:

1. Откройте страницу подключения MakePay.
2. Это позволяет вам выбрать компанию, которая будет получать выплаты.
3. Возвращает вас в WISECP после одобрения.
4. Сохраните соединение шлюза для этой установки WISECP.

После подключения создайте небольшой тестовый счет и оплатите его из личного кабинета.

Резервный вариант с ручным ключом API

Connect MakePay — рекомендуемая конфигурация. Конфигурация с помощью ручного ключа API доступна для установок, которые не могут выполнить управляемое соединение.

Для ручной настройки установите метод подключения api_key и введите:

• Идентификатор компании MakePay
• Идентификатор ключа API
• Секретный ключ API
• Секрет подписи webhook

Обеспечьте доступ к обратному вызову URL, созданному WISECP, из общедоступного Интернета.

Поток checkout

Когда клиент выбирает MakePay для счета WISECP, шлюз:

1. Считывает идентификатор checkout, сумму счета и валюту из WISECP.
2. Создайте размещенную ссылку для оплаты MakePay.
3. Отображает кнопку Оплатить с помощью MakePay.
4. Отправляет клиента на размещенный checkout.
5. Получите подписанный обратный звонок при изменении статуса платежа.

Ссылка для оплаты включает metadata как:

Поле	Цель
source=wisecp	Определить интеграцию
checkoutId	Сопоставляет активность MakePay обратно с checkout WISECP
orderId	Используйте идентификатор WISECP checkout для поиска обратного вызова.

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

Статус MakePay	Поведение WISECP
paid, completed, confirmed, succeeded	Отметить checkout как успешный
pending, waiting, confirming	Оставляет checkout в ожидании
failed, expired, cancelled	Пометить checkout как ошибку

WISECP продолжает нести ответственность за активацию услуги, продление срока действия, нумерацию счетов и уведомления клиентов после оплаты счетов.

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

Используйте HTTPS, ограничьте доступ администратора WISECP и отключите шлюз от информационной панели MakePay, если доступна учетная запись администратора или резервная копия сервера. Повторно подключитесь после изменения домена WISECP, чтобы URL-адреса обратного вызова и возврата соответствовали активной установке.

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

Если Connect MakePay не запускается, убедитесь, что шлюз установлен на coremio/modules/Payment/MakePay и что обратный вызов WISECP URL является общедоступным.

Если счета не обновляются, убедитесь, что секрет подписи webhook присутствует и что ваш сервер может получать обратные вызовы HTTPS от MakePay.

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