Шлюз Wix Velo

Обзор

MakePay для Wix использует плагин службы платежного провайдера Wix Velo. merchant добавляет четыре файла JavaScript из MakePay в редактор Wix, устанавливает crypto-js, подключает поставщика платежей в Настройки > Прием платежей и сохраняет секреты API в Wix Secrets Manager.

В checkout Wix вызывает createTransaction(). Серверный файл MakePay создает размещенную ссылку для оплаты MakePay и возвращает перенаправление URL в Wix. Когда MakePay подтверждает платеж, подписанный webhook вызывает функцию HTTP Wix, и код отправляет платеж в заказ Wix.

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

Вам нужно:

• Магазин Wix с включенным режимом разработчика
• Разрешение на редактирование внутренних файлов Velo и сервисных плагинов.
• Разрешение на использование Wix Secrets Manager
• Компания MakeCrypto с настроенным расчетом MakePay.
• Ключ API MakePay с доступом к написанию платных ссылок.
• Секрет webhook MakePay для компании

Создайте учетные данные MakePay

В MakeCrypto:

1. Выберите компанию, которая будет получать платежи Wix.
2. Откройте Кошелек > Балансы и настройте расчет.
3. Откройте Интеграции > Интеграции API и создайте ключ API.
4. Дайте ключ хотя бы:
   • makepay:payment-links:read
   • makepay:payment-links:write
5. Скопируйте идентификатор компании, идентификатор ключа API и секретный ключ API.
6. Откройте Продавец > Настройки платежей и поверните или скопируйте секрет webhook.

Секретный ключ API и секрет webhook добавляются в Wix Secrets Manager, а не в код внешнего интерфейса.

Добавить файлы Wix Velo

Откройте исходный репозиторий MakePay для Wix:

https://github.com/makecryptoio/makepay-wix

Тот же код сохраняется в этом монорепозитории под apps/plugins/wix.

В Виксе:

1. Откройте редактор сайта и включите Режим разработки.
2. В разделе Общедоступность и серверная часть > Серверная часть создайте:
   • MakePay.js
   • http-functions.js
3. В разделе Сервисные плагины создайте плагин Платежи с именем MakePayPayment.
4. Копировать:
   • MakePayPayment-config.js
   • MakePayPayment.js
5. Установите пакет npm crypto-js из раздела Пакеты и приложения.
6. Опубликуйте сайт.

Добавьте секреты Wix

Откройте Инструменты разработчика > Диспетчер секретов и добавьте:

Секретное имя	Ценность
makepay_api_key_secret	Секретный ключ API MakePay
makepay_webhook_secret	Секрет webhook MakePay

Не вставляйте эти значения в код страницы или файлы общедоступного интерфейса.

Подключите MakePay в Wix

Откройте Настройки > Прием платежей на панели управления Wix и подключите пользовательского поставщика платежей MakePay.

Входить:

Поле	Ценность
MakePay company ID	Идентификатор компании MakeCrypto
MakePay API key ID	Идентификатор ключа API MakePay
Settlement currency	Обычно USDT

Название способа оплаты в checkout:

Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others

Настроить webhooks

Конечная точка функции HTTP Wix:

https://your-wix-domain.com/_functions/makepay_notify

В MakeCrypto откройте Продавец > Настройки платежей и настройте обратный вызов URL MakePay с этой конечной точкой. Секрет webhook в Wix Secrets Manager должен совпадать с секретом webhook MakePay.

Обработчик Wix webhook проверяет заголовок X-MakePay-Signature, прежде чем пометить любой заказ как оплаченный.

Проверка checkout

1. Добавьте товар низкой стоимости в корзину Wix.
2. Перейдите к checkout.
3. Выберите метод криптовалютной оплаты MakePay.
4. Нажмите Оформить заказ и оплатить.
5. Убедитесь, что Wix перенаправляет на checkout, размещенный на MakePay.
6. Завершите пробный платеж.
7. Подтвердите, что заказ Wix помечен как оплаченный после получения webhook.
8. Проверьте Интеграции > Запросы Webhook в MakeCrypto, если запрос не обновлен.

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

При интеграции Wix используется аутентификация с ключом API, поскольку файлы Velo поставщика платежей, скопированные с помощью merchant, еще не поддерживают автоматический поток Connect MakePay.

Соблюдайте следующие правила:

• Сохраняйте секреты только в Wix Secrets Manager.
• Использует специальный ключ API из MakePay, а не широкий внутренний ключ.
• Не предоставляйте области отправки кошелька или управление ключами API.
• Поменяйте ключ API и секрет webhook, если кто-то со старым доступом к редактору Wix больше не должен управлять платежами.
• Держите обратный вызов HTTPS URL общедоступным.

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

Если поставщик не указан в разделе Прием платежей, убедитесь, что плагин службы называется MakePayPayment, что оба файла плагина существуют и что сайт был опубликован после добавления кода.

Если Подключиться не удалось, убедитесь, что makepay_api_key_secret существует в Wix Secrets Manager и что идентификатор ключа API/идентификатор компании соответствует той же компании MakeCrypto.

Если checkout не перенаправляется, проверьте журналы Wix Velo на наличие ошибки createTransaction и убедитесь, что ключ API имеет makepay:payment-links:write.

Если заказы не обновляются, подтвердите, что обратный вызов URL для MakeCrypto — это https://your-wix-domain.com/_functions/makepay_notify, что секрет webhook совпадает и что в журналах доставки MakeCrypto отображается ответ 2xx.