faq

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

Обновлено: 09.03.2026

Платеж не получен

Клиент утверждает, что заплатил, но транзакция имеет статус «В ожидании» или транзакция не отображается.

Проверьте блокчейн: Используйте обозреватель блокчейна (например, Etherscan, Blockchain.com), чтобы проверить хеш транзакции. Убедитесь, что платеж был отправлен на правильный адрес.

Проверьте подтверждения: Возможно, платеж ожидает необходимого количества подтверждений. Перейдите в вашу панель управления → Транзакции и посмотрите статус транзакции.

Проверьте сумму: Если клиент отправил сумму меньше необходимой, транзакция будет помечена как недоплаченная, если не включена опция «Принимать недоплаты».

Проверьте адрес: Убедитесь, что клиент отправил средства на правильный адрес кошелька и в правильной сети. Распространенная ошибка — отправка токенов ERC-20 на адрес TRC-20 (разные сети, средства могут быть потеряны).

Проверьте криптовалюту: Убедитесь, что клиент заплатил выбранной криптовалютой, а не другим токеном в той же сети.

Если транзакция подтверждена в блокчейне, но не отображается в QuantaPay, используйтеcheck-transactionAPI, чтобы принудительно выполнить повторную проверку.
Если платеж был отправлен на неправильный адрес или в неправильную сеть, QuantaPay не может вернуть средства.

Платежи завершены в панели управления QuantaPay, но ваш сервер не получает уведомления webhook.

Проверьте URL-адрес webhook: Перейдите в Настройки → Платежи → Webhook и убедитесь, что URL-адрес указан правильно.

Проверьте доступность конечной точки: Убедитесь, что ваша конечная точка webhook общедоступна через HTTPS. Протестируйте с помощью curl:

   curl -X POST https://yoursite.com/wp-json/quantapay/webhook \
     -H "Content-Type: application/json" \
     -d '{"test": true}'

Проверьте логи сервера: Найдите входящие POST-запросы к вашей конечной точке webhook. Если их нет, проблема с доставкой. Если есть ошибки 500, проблема в коде вашего обработчика.

Брандмауэр / WAF: Если вы используете Cloudflare, убедитесь, что конечная точка webhook разрешена (см.WordPress / WooCommerceдля конфигурации Cloudflare).

Проверьте статус webhook: В вашей панели управления → Транзакции в столбце «Webhook» отображается1, если webhook был отправлен для этой транзакции.

Исправьте URL-адрес webhook или доступность конечной точки.
Временно используйте сервис тестирования webhook (webhook.site), чтобы убедиться, что QuantaPay отправляет webhooks.
В качестве запасного варианта опрашивайтеget-checkout-sessionAPI для проверки статуса платежа.

Ошибка	Причина	Решение
`api-key-not-found`	Отсутствует`api-key`параметр.	Добавьте`api-key`в каждый POST-запрос.
`invalid-api-key`	Неверный API key.	Скопируйте правильный ключ в Settings → Account.
`function-not-found`	Опечатка в названии функции.	Проверьте написание названия функции.
`missing-argument`	Отсутствует обязательный параметр.	Проверьте документацию API на наличие обязательных параметров.
Connection timeout	Проблема с сетью или сервер не работает.	Повторите попытку через несколько секунд.
SSL error	Проблема с сертификатом.	Убедитесь, что CA-сертификаты вашего сервера обновлены.

Тестирование с помощью curl: Используйте curl, чтобы определить, где проблема: в вашем коде или в API:

   curl -X POST https://cloud.quantapay.app/api.php \
     -d "function=get-balances" \
     -d "api-key=YOUR_API_KEY"

Проверка формата ответа: Все ответы соответствуют формату{"success": true/false, ...}. Проанализируйте полеsuccessперед доступом кresponse.