Шлюз MakePay для Blesta

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

Регулярное выставление счетов остается в Blesta. Когда Blesta создает счет за продление, шлюз обрабатывает его как любую другую оплату счета.

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

Вам нужно:

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

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

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

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

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

Blesta/components/gateways/nonmerchant/makepay

В Blesta откройте Настройки > Платежные шлюзы, выберите Доступно, найдите MakePay и установите его как шлюз, отличный от merchant.

Подключите MakePay

Откройте настройки шлюза MakePay в Blesta и нажмите Подключить MakePay.

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

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

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

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

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

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

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

Держите обратный вызов URL, отображаемый в Blesta, доступный из общедоступного Интернета.

Поток checkout

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

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

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

Поле	Цель
source=blesta	Определить интеграцию
orderId=blesta_invoice_<invoiceId>	Сопоставляет активность MakePay с Блестой
invoiceId	Основной идентификатор счета-фактуры Blesta
clientId	Идентификатор клиента Blesta, когда доступен

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

Статус MakePay	Поведение Блесты
paid, completed, confirmed, succeeded	Запишите одобренную транзакцию
pending, waiting, confirming	Держит платеж в ожидании
failed, expired, cancelled	Зафиксировать отклоненный платеж

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

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

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

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

Если Connect MakePay не запускается, убедитесь, что обратный вызов Blesta URL является общедоступным и что шлюз установлен как не-merchant.

Если счета-фактуры не обновляются, убедитесь, что обратный вызов URL, отображаемый в настройках, доступен и присутствует секрет подписи webhook.

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