MakePay Шлюз для сообщества Invision

Обзор

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

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

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

• Сообщество Invision 5.0 или выше
• Установлено коммерческое приложение
• PHP 8.1 или выше
• URL HTTPS-сообщество
• Компания MakePay, где вы можете управлять корректировкой платежей.

Установите приложение

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

https://plugins.makecrypto.io/downloads/invision-community/latest.tar

Установите его из диспетчера приложений Invision AdminCP.

Подключите MakePay

Откройте настройки платежей Commerce и добавьте MakePay в качестве способа оплаты. Выберите «Подключить MakePay». Приложение:

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

Настроить MakePay

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

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

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

Поток checkout

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

Поле	Цель
source=invision	Определить интеграцию
externalId=invision_invoice_<id>	Сопоставляет активность MakePay с торговлей
invoiceId	Идентификатор счета Invision Commerce
transactionId	Идентификатор транзакции Invision Commerce
moduleVersion	Установленная версия приложения MakePay

Участник перенаправляется на размещенный checkout MakePay и возвращается в сообщество после оплаты или отмены.

Статусы Commerce

Конечная точка webhook проверяет X-MakePay-Signature перед изменением статуса коммерческой транзакции.

Статус MakePay	Статус транзакции Invision
paid, completed, confirmed, succeeded	Одобренный
failed, expired	Отказался
cancelled, canceled	Отказался
refunded	Возвращено
Другие штаты	В ожидании

Каждый webhook записывает личное сообщение со счетом со статусом MakePay, UID Payment и URL Hosted Payment, если они доступны.

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

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