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

Interaktive Referenz zur XPayr REST API v1.

Prüfen Sie jeden Produktions- und Testnet-Endpunkt direkt aus unserer kanonischen /.well-known/openapi.json -Spezifikation, laden Sie unsere sofort einsatzbereite Postman v2.1 Collectionherunter oder generieren Sie vollständigen Anwendungscode in 8 Sprachen.

📥 Postman Collection v2.1 herunterladen 📄 OpenAPI 3.1.0 Spezifikation ⚙️ Code-Generator für 8 Sprachen 🌐 Scalar / Swagger Portal

GET /api/v1/health Systemstatus

xpayr_health_check

API-Gateway-Systemstatusprüfung

Überprüfen Sie den Betriebsstatus, die Version und den Server-Zeitstempel der XPayr Gateway API v1.

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

POST /api/v1/payments Zahlungen & Checkout

xpayr_create_payment_session

Krypto-Zahlungssitzung erstellen (Dualer Checkout)

Erstellen Sie eine nicht-verwahrende Krypto-Zahlungssitzung mit Unterstützung für Web3 1-Klick-Zahlung, direkte Börsen-QR-Überweisung, Multi-Chain-Links, 1 Jahr wiederverwendbare Links und automatischen HTML-Rechnungsversand per E-Mail.

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 Zahlungen & Checkout

xpayr_list_payment_sessions

Händler-Zahlungssitzungen auflisten

Listen Sie Krypto-Zahlungssitzungen des Händlers mit Filterung nach Status, Währung, Netzwerk und Paginierung auf.

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

GET /api/v1/payments/{session_id} Zahlungen & Checkout

xpayr_get_payment_session

Details der Zahlungssitzung abrufen

Rufen Sie vollständige Details, Metadaten, Abrechnungsaufteilungsbeträge, den Checkout-Modus und den On-Chain-Transaktions-Hash für eine Zahlungssitzung ab.

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 Zahlungen & Checkout

xpayr_get_public_payment_status

Öffentlichen On-Chain-Zahlungsstatus abfragen

Fragen Sie den öffentlichen Echtzeit-Checkout-Status, den On-Chain-tx_hash, die Absender-Wallet-Adresse, Blockbestätigungen und den paid_at-Zeitstempel ohne API-Schlüssel ab.

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

POST /api/v1/payments/{session_id}/coupon Zahlungen & Checkout

xpayr_apply_payment_coupon

Checkout-Rabattgutschein anwenden

Validieren Sie einen Aktions-Rabattgutscheincode des Händlers und wenden Sie ihn auf eine aktive ausstehende Zahlungssitzung an.

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 Händler & Profil

xpayr_get_merchant_profile

Händlerprofil & Abrechnungs-Wallet abrufen

Rufen Sie das authentifizierte Händlerprofil, die Abrechnungs-Wallet-Adresse, den Provisionssatz in Basispunkten (50 bps = 0.5%) und aktive API-Schlüssel ab.

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

GET /api/v1/me/balance Händler & Profil

xpayr_get_merchant_balance

Multi-Chain-Abrechnungsvolumen & Saldo abrufen

Fragen Sie das bestätigte nicht-verwahrende Abrechnungsvolumen, Transaktionszahlen und Plattformgebühren gruppiert nach Währung und Blockchain-Netzwerk ab.

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

GET /api/v1/me/networks Händler & Profil

xpayr_get_supported_networks

Unterstützte Netzwerke, Chains & Token auflisten

Listen Sie alle aktiven EVM-, TRON-, Solana- und Arc-Mainnet/Testnet-Blockchain-Netzwerke, Chain-IDs, RPC-Endpunkte, Splitter-Verträge und unterstützten Token auf.

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

GET /api/v1/webhooks Webhooks

xpayr_get_webhook_config

Webhook-Konfiguration & Ereignisse abrufen

Prüfen Sie die Webhook-Callback-URL des Händlers, das maskierte HMAC-SHA256-Signaturgeheimnis und abonnierte Zahlungslebenszyklus-Ereignisse.

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

POST /api/v1/webhooks Webhooks

xpayr_set_webhook_endpoint

HTTPS-Webhook-Endpunkt konfigurieren

Konfigurieren oder aktualisieren Sie die HTTPS-Webhook-Empfänger-URL des Händlers und generieren Sie ein neues 32-Byte-HMAC-SHA256-Signaturgeheimnis.

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 Webhooks

xpayr_send_test_webhook

Signiertes Test-Webhook-Ereignis senden

Senden Sie eine signierte test.webhook-Nutzlast mit HMAC-SHA256-Headern, um die Webhook-Signaturprüfung des Händlers zu testen.

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

POST /api/v1/agents KI-Agenten-Commerce

xpayr_create_ai_agent

Richtliniengesteuerten KI-Commerce-Agenten erstellen

Stellen Sie eine neue händlerverwaltete KI-Commerce-Agenten-Identität mit bereichsbezogenen Zugangsdaten und programmierbaren Ausgabenleitplanken bereit.

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 KI-Agenten-Commerce

xpayr_list_ai_agents

KI-Commerce-Agenten des Händlers auflisten

Listen Sie alle vom Händler verwalteten KI-Commerce-Agenten samt Status, zugewiesenen Wallets und Ausgabenrichtlinien auf.

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

PUT /api/v1/agents/{agent_id}/policy KI-Agenten-Commerce

xpayr_update_ai_agent_policy

KI-Agenten-Ausgabenleitplanken aktualisieren

Konfigurieren Sie Ausgabenrichtlinien-Leitplanken für einen KI-Agenten (Max. USD pro Transaktion, Tageslimit, Auto-Freigabe-Schwellenwert, erlaubte Chains/Token).

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 KI-Agenten-Commerce

xpayr_submit_agent_payment_intent

Autonomen KI-Agenten-Zahlungsauftrag einreichen

Reichen Sie einen autonomen KI-Agenten-Zahlungsauftrag ein, der in Echtzeit anhand der Händlerrichtlinien bewertet wird (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 KI-Agenten-Commerce

xpayr_list_agent_payment_intents

KI-Agenten-Zahlungsaufträge & Audit-Logs auflisten

Listen Sie KI-Agenten-Zahlungsaufträge, Richtlinienbewertungen und Prüfpfad-Einträge für den Händler auf.

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 KI-Agenten-Commerce

xpayr_bridge_agent_intent_to_checkout

Genehmigten Agenten-Auftrag in Checkout-Sitzung überführen

Überführen Sie einen genehmigten KI-Agenten-Zahlungsauftrag in eine ausführbare Live-XPayr-Zahlungssitzung mit gehosteter Checkout-URL und On-Chain-Verifizierung.

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 KI-Agenten-Commerce

xpayr_approve_agent_intent

Ausstehenden KI-Agenten-Auftrag genehmigen (Human-in-the-Loop)

Genehmigen Sie einen ausstehenden KI-Agenten-Zahlungsauftrag aus der Freigabewarteschlange des Händlers und überführen Sie ihn in den Checkout.

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 KI-Agenten-Commerce

xpayr_reject_agent_intent

Ausstehenden KI-Agenten-Auftrag ablehnen

Lehnen Sie einen ausstehenden KI-Agenten-Zahlungsauftrag in der Freigabewarteschlange des Händlers mit einem Audit-Grund ab.

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 Integration – Häufige Fragen

Welche Basis-URL und welches Authentifizierungsschema verwendet die 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.

Kann ich die XPayr API v1 direkt in Postman, Insomnia, Bruno oder Cursor importieren?

Ja! Importieren Sie https://xpayr.com/postman.json (Postman Collection v2.1) oder https://xpayr.com/.well-known/openapi.json (OpenAPI 3.1.0) mit einem Klick.

Sind Testnet-API-Antworten strukturell identisch mit dem Mainnet?

Ja. Der Wechsel von sk_test_ zu sk_live_ behält exakt dieselben Endpunkt-URLs, JSON-Feldnamen und HMAC-SHA256-Webhook-Ereignisschemata bei.