WordPress / WooCommerce

Принимайте криптовалютные платежи в своем магазине WooCommerce с помощью официального плагина QuantaPay Payment.

Требования

• WordPress 5.8+
• WooCommerce (любая последняя версия)
• PHP 7.4+ (рекомендуется PHP 8.x)
• Аккаунт QuantaPay Cloud (cloud.quantapay.app)

Установка

Из каталога плагинов WordPress

1. Перейдите в разделПлагины → Добавить новыйв панели администратора WordPress.
2. Найдите"QuantaPay Payment".
3. НажмитеУстановить, затемАктивировать.

Ручная установка

1. Скачайте плагин с сайтаwordpress.org/plugins/quantapay-payment.
2. Загрузите папкуquantapay-paymentв/wp-content/plugins/.
3. Активируйте плагин в разделеПлагины → Установленные плагины.

Настройка

Шаг 1: Получите свои учетные данные

На панели управления QuantaPay Cloud:

1. API Key— находится в разделеSettings → Account
2. Webhook Secret Key— находится в разделеSettings → Payments → Webhook

Шаг 2: Введите учетные данные в WordPress

1. Перейдите в менюQuantaPayна боковой панели WordPress.
2. Вставьте свойКлюч Cloud APIиWebhook Secret Key.
3. Сохранить настройки.

Шаг 3: Настройте URL-адрес Webhook

1. Плагин генерирует URL-адрес webhook:https://yoursite.com/wp-json/quantapay/webhook
2. Скопируйте этот URL-адрес и вставьте его вCloud → Settings → Payments → Webhook URL.

Шаг 4: Включите шлюз

Перейдите в разделWooCommerce → Settings → Payments → QuantaPayи включите его.

Настройки WooCommerce

Плагин добавляет настройки непосредственно на странице платежей WooCommerce:

Быстрая настройка

Боковое менюQuantaPayпредоставляет вкладку быстрой настройки, где вы можете управлять:

• Адресами кошельков
• Валютой по умолчанию
• URL-адресом перенаправления страницы благодарности
• Текстом/сообщениями оформления заказа

Изменения, внесенные здесь, синхронизируются с вашими настройками QuantaPay Cloud.

Поддержка блочного оформления заказа

Плагин полностью поддерживает блочное оформление заказа WooCommerce (новое оформление заказа на основе React). Как классическое, так и блочное оформление заказа используют одну и ту же конфигурацию и отображают полосу значков криптовалют (BTC, ETH, USDT, USDC, BNB).

Процесс оплаты

1. Клиент выбирает «Оплатить криптовалютой» при оформлении заказа.
2. WooCommerce создает заказ и вызывает QuantaPay Checkout Session API.
3. Клиент перенаправляется на платежную страницу QuantaPay.
4. Клиент выбирает криптовалюту, сканирует QR-код и отправляет платеж.
5. После подтверждения в blockchain QuantaPay отправляет webhook на ваш сайт WordPress.
6. Плагин обновляет статус заказа WooCommerce на "В обработке" или "Завершен".
7. Клиент перенаправляется на страницу благодарности WooCommerce.

Синхронизация панели управления

На странице администратора QuantaPay в WordPress вы можете:

• Просматривать баланс своего кошелька
• Просматривать последние 100 транзакций
• Проверять журналы отладки
• Просматривать уведомления о недоплатах и просроченных счетах

Безопасность

• Webhooks проверяются с использованием подписи общего секретного ключа.
• Конфиденциальные настройки (ключи API) шифруются в состоянии покоя.
• Подписи HMAC-SHA256 защищают создание сеанса оформления заказа от несанкционированного доступа.
• Журналы отладки автоматически удаляют секреты.

Конфигурация Cloudflare / WAF

Если ваш сайт находится за Cloudflare или другим WAF, разрешите конечную точку webhook:

1. Создайте правило Firewall/WAF, соответствующееURI содержит /wp-json/quantapay.
2. Установите действие наРазрешитьилиОбход защиты.
3. Убедитесь, что для этого URL-адреса не установлен уровень безопасности "Я под атакой".

Поддерживаемые языки

Плагин поставляется с переводами на 9 языков:

• Английский, китайский (упрощенный), испанский, португальский (бразильский), русский, французский, японский, корейский, немецкий

Цены

QuantaPay взимает фиксированную плату0,8% за каждый успешный криптоплатеж. Без ежемесячной платы или комиссий за вывод средств.