401 authentication_required
Ключ Bearer отсутствует или недействителен.
Используйте правильный тестовый или боевой секретный ключ в заголовке Authorization.
Отлаживайте быстрее
Превратите каждую ошибку API в следующее действие.
Большинство проблем интеграции связаны с аутентификацией, валидацией, вебхуками, поддержкой маршрута или опросом. Это руководство сопоставляет симптом с решением.
400 validation_error
Обязательное поле отсутствует или недействительно.
Проверьте сумму, валюту, сеть, URL вебхука, адрес кошелька и формат JSON.404 not_found
Платёжная сессия или конечная точка не найдена.
Проверьте идентификатор сессии и путь маршрута. Для публичного статуса используйте /payments/{id}/status.409 fee_delegation_unavailable
Настройки делегирования комиссии, маршрут или поддержка сети не активны.
Используйте стандартную оплату кошельком или сначала активируйте политику продавца и поддерживаемый маршрут.Ошибка доставки вебхука 422
Конечная точка продавца не вернула статус 2xx.
Проверьте HTTPS, разбор сырого тела, проверку подписи, таймаут и правила брандмауэра.429 rate_limited
Слишком много аутентифицированных запросов к API.
Сделайте паузу, повторите позже и не опрашивайте слишком часто.Всё ещё не получается?
Отправьте ID запроса, конечную точку, ID сессии, код ответа и очищенные данные. Никогда не отправляйте приватные ключи или секреты вебхуков.
Связаться с поддержкой Открыть документацию API Проверить ошибки JSON-RPC в песочнице MCP Отладка ошибок 422 подписей вебхуков
Официальные NPM SDK (v0.2.0) и удаленный MCP-сервер
Быстрая интеграция с официальными пакетами XPayr и MCP без установки
Установите @xpayr/node-sdk (v0.2.0), @xpayr/payment-evidence (v0.2.0), @xpayr/extension-kit (v0.2.0)или @xpayr/mcp-server (v1.0.0) из NPM или выполняйте живые вызовы инструментов JSON-RPC 2.0 через POST https://xpayr.com/api/mcp.