OpenAPI 3.1.0 · 20 Endpoints · Base URL: https://xpayr.com/api/v1

Интерактивный справочник XPayr REST API v1.

Изучите каждый эндпоинт продакшена и Testnet напрямую из нашей канонической спецификации /.well-known/openapi.json , скачайте готовую к запуску коллекцию Postman v2.1или сгенерируйте полный код приложения на 8 языках.

📥 Скачать коллекцию Postman v2.1 📄 Спецификация OpenAPI 3.1.0 ⚙️ Генератор кода на 8 языках 🌐 Портал Scalar / Swagger

GET /api/v1/health Состояние системы

xpayr_health_check

Проверка работоспособности API-шлюза

Проверьте операционный статус, версию и серверную метку времени XPayr Gateway API v1.

curl -X GET "https://xpayr.com/api/v1/health"

POST /api/v1/payments Платежи и Checkout

xpayr_create_payment_session

Создать сессию криптоплатежа (Двойной Checkout)

Создайте некастодиальную сессию криптооплаты с поддержкой оплаты Web3 в 1 клик, прямого биржевого QR-перевода, мультисетевых ссылок, многоразовых ссылок на 1 год и автоматической отправки HTML-инвойсов по email.

curl -X POST "https://xpayr.com/api/v1/payments" \
  -H "Authorization: Bearer sk_test_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"amount":49.9,"currency":"USDT","network":"tron-mainnet","order_id":"ORD-1001","description":"Pro SaaS Annual Plan","is_multi_chain":true,"is_reusable":false,"send_invoice_email":true,"customer_email":"buyer@example.com","ipn_callback_url":"https://example.com/webhooks/xpayr"}'

GET /api/v1/payments Платежи и Checkout

xpayr_list_payment_sessions

Список платёжных сессий мерчанта

Просматривайте криптоплатёжные сессии мерчанта с фильтрацией по статусу, валюте, сети и пагинацией.

curl -X GET "https://xpayr.com/api/v1/payments" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

GET /api/v1/payments/{session_id} Платежи и Checkout

xpayr_get_payment_session

Получить детали платёжной сессии

Получите полные данные, метаданные, суммы распределения расчётов, режим оплаты и ончейн-хеш транзакции для платёжной сессии.

curl -X GET "https://xpayr.com/api/v1/payments/{session_id}" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

GET /api/v1/payments/{session_id}/status Платежи и Checkout

xpayr_get_public_payment_status

Опрос публичного ончейн-статуса платежа

Запрашивайте публичный статус оплаты в реальном времени, ончейн tx_hash, адрес кошелька отправителя, подтверждения блоков и метку paid_at без API-ключа.

curl -X GET "https://xpayr.com/api/v1/payments/{session_id}/status"

POST /api/v1/payments/{session_id}/coupon Платежи и Checkout

xpayr_apply_payment_coupon

Применить скидочный купон при оплате

Проверьте и примените промокод на скидку мерчанта к активной ожидающей сессии оплаты.

curl -X POST "https://xpayr.com/api/v1/payments/{session_id}/coupon" \
  -H "Authorization: Bearer sk_test_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"coupon_code":"XPAYR-DEMO"}'

GET /api/v1/me Мерчант и профиль

xpayr_get_merchant_profile

Получить профиль мерчанта и кошелёк расчётов

Получите аутентифицированный профиль мерчанта, адрес кошелька для расчётов, ставку комиссии в базисных пунктах (50 bps = 0.5%) и активные API-ключи.

curl -X GET "https://xpayr.com/api/v1/me" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

GET /api/v1/me/balance Мерчант и профиль

xpayr_get_merchant_balance

Получить мультисетевой объём расчётов и баланс

Запрашивайте подтверждённый некастодиальный объём расчётов, количество транзакций и комиссии платформы с группировкой по валютам и блокчейн-сетям.

curl -X GET "https://xpayr.com/api/v1/me/balance" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

GET /api/v1/me/networks Мерчант и профиль

xpayr_get_supported_networks

Список поддерживаемых сетей, чейнов и токенов

Получите список всех активных блокчейн-сетей EVM, TRON, Solana и Arc Mainnet/Testnet, ID сетей, RPC-узлов, контрактов-сплиттеров и поддерживаемых токенов.

curl -X GET "https://xpayr.com/api/v1/me/networks" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

GET /api/v1/webhooks Вебхуки

xpayr_get_webhook_config

Получить конфигурацию и события вебхуков

Просмотрите URL обратного вызова вебхука мерчанта, замаскированный секрет подписи HMAC-SHA256 и подписки на события жизненного цикла платежа.

curl -X GET "https://xpayr.com/api/v1/webhooks" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

POST /api/v1/webhooks Вебхуки

xpayr_set_webhook_endpoint

Настроить HTTPS-эндпоинт вебхука

Настройте или обновите HTTPS URL получателя вебхуков мерчанта и сгенерируйте новый 32-байтовый секретный ключ подписи HMAC-SHA256.

curl -X POST "https://xpayr.com/api/v1/webhooks" \
  -H "Authorization: Bearer sk_test_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/webhooks/xpayr"}'

POST /api/v1/webhooks/test Вебхуки

xpayr_send_test_webhook

Отправить подписанное тестовое событие вебхука

Отправьте подписанную полезную нагрузку test.webhook с заголовками HMAC-SHA256 для проверки верификации подписи вебхуков на стороне мерчанта.

curl -X POST "https://xpayr.com/api/v1/webhooks/test" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

POST /api/v1/agents Коммерция ИИ-агентов

xpayr_create_ai_agent

Создать ИИ-агента коммерции с контролем политик

Создайте новую управляемую мерчантом учётную запись ИИ-агента коммерции с ограниченными учётными данными и программируемыми лимитами расходов.

curl -X POST "https://xpayr.com/api/v1/agents" \
  -H "Authorization: Bearer sk_test_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"name":"Autonomous Cloud Buyer","description":"Pays API and compute invoices under $50 automatically.","wallet_address":"0x71C...89A"}'

GET /api/v1/agents Коммерция ИИ-агентов

xpayr_list_ai_agents

Список ИИ-агентов коммерции мерчанта

Просмотрите всех управляемых мерчантом ИИ-агентов коммерции вместе с их статусом, назначенными кошельками и политиками расходов.

curl -X GET "https://xpayr.com/api/v1/agents" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

PUT /api/v1/agents/{agent_id}/policy Коммерция ИИ-агентов

xpayr_update_ai_agent_policy

Обновить лимиты расходов ИИ-агента

Настройте ограничения политики расходов для ИИ-агента (макс. USD за транзакцию, дневной лимит, порог автоодобрения, разрешённые сети и токены).

curl -X PUT "https://xpayr.com/api/v1/agents/{agent_id}/policy" \
  -H "Authorization: Bearer sk_test_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"max_tx_amount":100,"daily_limit_amount":500,"auto_approve_under":25}'

POST /api/v1/agent-intents Коммерция ИИ-агентов

xpayr_submit_agent_payment_intent

Отправить автономное платёжное намерение ИИ-агента

Отправьте автономное платёжное намерение ИИ-агента, оцениваемое в реальном времени по правилам политики мерчанта (approved, pending_approval, rejected).

curl -X POST "https://xpayr.com/api/v1/agent-intents" \
  -H "Authorization: Bearer sk_test_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"amount":19.99,"currency":"USDC","network":"arc-testnet","recipient_address":"0xb0bD2f3A86db752dA693D8a686C406E269E57c99","reason":"Monthly GPU cluster invoice #402"}'

GET /api/v1/agent-intents Коммерция ИИ-агентов

xpayr_list_agent_payment_intents

Список платёжных намерений ИИ-агентов и журналов аудита

Просмотрите платёжные намерения ИИ-агентов, решения по оценке политик и записи аудиторского следа для мерчанта.

curl -X GET "https://xpayr.com/api/v1/agent-intents" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

POST /api/v1/agent-intents/{intent_id}/bridge Коммерция ИИ-агентов

xpayr_bridge_agent_intent_to_checkout

Преобразовать одобренное намерение агента в сессию оплаты

Преобразуйте одобренное платёжное намерение ИИ-агента в активную исполняемую платёжную сессию XPayr с размещённым URL оплаты и ончейн-проверкой.

curl -X POST "https://xpayr.com/api/v1/agent-intents/{intent_id}/bridge" \
  -H "Authorization: Bearer sk_test_your_workspace_key"

POST /api/v1/agent-approvals/{intent_id}/approve Коммерция ИИ-агентов

xpayr_approve_agent_intent

Одобрить ожидающее намерение ИИ-агента (с участием человека)

Одобрите ожидающее платёжное намерение ИИ-агента из очереди подтверждения мерчанта и переведите его в сессию оплаты.

curl -X POST "https://xpayr.com/api/v1/agent-approvals/{intent_id}/approve" \
  -H "Authorization: Bearer sk_test_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"note":"Approved by Treasury Manager"}'

POST /api/v1/agent-approvals/{intent_id}/reject Коммерция ИИ-агентов

xpayr_reject_agent_intent

Отклонить ожидающее намерение ИИ-агента

Отклоните ожидающее платёжное намерение ИИ-агента в очереди подтверждения мерчанта с указанием причины для аудита.

curl -X POST "https://xpayr.com/api/v1/agent-approvals/{intent_id}/reject" \
  -H "Authorization: Bearer sk_test_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Exceeds vendor budget allocation"}'

Частые вопросы по интеграции API v1

Какой базовый URL и схему аутентификации использует XPayr API v1?

All REST API v1 endpoints are served from https://xpayr.com/api/v1 using standard Bearer token authentication (Authorization: Bearer sk_test_... for Testnet or sk_live_... for Mainnet). Public endpoints like GET /api/v1/health and GET /api/v1/payments/{session_id}/status require no secret key.

Можно ли импортировать XPayr API v1 напрямую в Postman, Insomnia, Bruno или Cursor?

Да! Импортируйте https://xpayr.com/postman.json (коллекция Postman v2.1) или https://xpayr.com/.well-known/openapi.json (OpenAPI 3.1.0) в один клик.

Идентичны ли по структуре ответы API в Testnet и Mainnet?

Да. Переход с sk_test_ на sk_live_ сохраняет абсолютно те же URL эндпоинтов, имена полей JSON и схемы событий вебхуков HMAC-SHA256.