Обзор

Плагин QuantaPay Payment наWordPress.orgдобавляет некастодиальный криптошлюз в WooCommerce (классическое оформление заказа, Blocks, HPOS) и Easy Digital Downloads. Используйте этот документ, чтобы держать каждый шаг в одном месте, вместо того чтобы переключаться между FAQ/Readme файлами.

Требования

• WordPress 5.8+ с WooCommerce 6.0+ или EDD 3.0+, PHP 7.4+ (8.x рекомендуется).

• Исходящий HTTPS доступ к cloud.quantapay.app для API + проверки Webhook.

• Активное рабочее пространство QuantaPay Cloud с API Key и Webhook Secret.

• Возможность разрешить запросы к https://yoursite.com/wp-json/quantapay/webhook через WAF/Cloudflare.

Установка плагина

1) Загрузите последний zip-файл с WordPress.org или из вашей внутренней сборки.

2) В админке WordPress перейдите в Plugins → Add New → Upload Plugin и загрузите quantapay-payment.zip.

3) Активируйте “QuantaPay Payment”. Появится новый экран Settings → QuantaPay для учетных данных.

Настройка учетных данных и оформления заказа

• ОткройтеSettings → QuantaPayи вставьте Cloud API Key + Webhook Secret, затем сохраните. На странице отображается сгенерированный Webhook URL (https://yourdomain.com/wp-json/quantapay/webhook).

• WooCommerce: перейдите вWooCommerce → Settings → Payments → QuantaPay(или Payments → Manage в новом интерфейсе) и переключите “Enable”. Выберите заголовок/описание оформления заказа и валюту по умолчанию.

• Быстрая настройка: по-прежнему в Settings → QuantaPay вы можете синхронизировать адреса кошельков, перенаправление на страницу благодарности, локализованную копию оформления заказа и настройки ведения журнала без редактирования PHP.

• Easy Digital Downloads: включите шлюз в разделеDownloads → Settings → Payment Gateways → QuantaPayчтобы отобразить его в формах оформления заказа EDD.

Чек-лист Webhook и брандмауэра

1) В QuantaPay Cloud перейдите в Settings → Webhooks и вставьте конечную точку WordPress, указанную в плагине. Нажмите “Verify Secret”, чтобы сохранить подпись.

2) Если вы используете Cloudflare или другой WAF, создайте правило: Hostname equals yourdomain.com AND URI contains /wp-json/quantapay, действие Allow/Bypass. При необходимости отфильтруйте по user agent QuantaPay-Webhook или заголовку подписи.

3) Не переводите сайт в режим “I’m Under Attack” для этой конечной точки, чтобы подписанные обратные вызовы достигали WordPress до того, как плагин их проверит.

Тестирование и устранение неполадок

• Разместите тестовый заказ на 1 доллар в WooCommerce или EDD и выберите QuantaPay. Убедитесь, что на размещенной странице отображается та же валюта и сумма.

• В QuantaPay Cloud отметьте счет как оплаченный или отправьте реальный крипто-перевод; WordPress должен переместить заказ из Pending в Processing/Completed с хешем блокчейна, сохраненным в примечаниях к заказу.

• Если заказы не обновляются, проверьте Cloud API Key/Webhook Secret, убедитесь, что Cloudflare разрешает конечную точку, и просмотрите wp-content/uploads/quantapay/quantapay-debug.log (включайте ведение журнала только во время тестирования; секреты отредактированы).

• Используйте кнопку “Test Cloud API” внутри Settings → QuantaPay, чтобы подтвердить учетные данные и обновить снимки кошелька без создания нового заказа.

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

Деактивация плагина сохраняет конфигурацию для последующего использования. Выбор Delete удаляет сохраненные параметры и настройки ведения журнала, но никогда не затрагивает заказы WooCommerce или EDD. Всегда делайте резервную копию перед заменой коннектора в production.

Полезные ссылки

•Загрузка / журнал изменений на WordPress.org

•Панель управления QuantaPay Cloud

•Индекс документации

• Поддержка:[email protected]

Нужна помощь?

Требуется помощь? Напишите на[email protected]и укажите URL сайта и номер заказа.