401 authentication_required
Bearer-Schluessel fehlt oder ist ungueltig.
Verwenden Sie den richtigen Test- oder Live-Secret-Key im Authorization-Header.
Schneller debuggen
Machen Sie aus jedem API-Fehler einen naechsten Schritt.
Die meisten Integrationsprobleme betreffen Authentifizierung, Validierung, Webhooks, Routenunterstuetzung oder Polling. Dieser Leitfaden ordnet dem Symptom die naechste Loesung zu.
400 validation_error
Pflichtfeld fehlt oder ist ungueltig.
Pruefen Sie Betrag, Waehrung, Netzwerk, Webhook-URL, Wallet-Adresse und JSON-Format.404 not_found
Zahlungssitzung oder Endpunkt wurde nicht gefunden.
Pruefen Sie Session-ID und Routenpfad. Fuer den oeffentlichen Status /payments/{id}/status verwenden.409 fee_delegation_unavailable
Einstellungen zur Gebuehrendelegation, Route oder Netzwerkunterstuetzung sind nicht aktiv.
Nutzen Sie den Standard-Wallet-Checkout oder aktivieren Sie zuerst die Haendlerrichtlinie und die unterstuetzte Route.422 Webhook-Zustellung fehlgeschlagen
Der Haendler-Endpunkt hat keinen 2xx-Status zurueckgegeben.
Pruefen Sie HTTPS, Raw-Body-Parsing, Signaturpruefung, Timeout und Firewall-Regeln.429 rate_limited
Zu viele authentifizierte API-Anfragen.
Warten Sie, versuchen Sie es spaeter erneut und pollen Sie nicht zu haeufig.Immer noch blockiert?
Senden Sie Request-ID, Endpunkt, Session-ID, Antwortcode und bereinigte Payload. Senden Sie niemals private Schluessel oder Webhook-Secrets.
Support kontaktieren API-Dokumentation oeffnen JSON-RPC-Fehler im MCP-Playground prüfen 422-Webhook-Signaturen debuggen
Offizielle NPM-SDKs (v0.2.0) & Remote-MCP-Server
Schneller integrieren mit offiziellen XPayr-Paketen & installationsfreiem MCP
Installieren Sie @xpayr/node-sdk (v0.2.0), @xpayr/payment-evidence (v0.2.0), @xpayr/extension-kit (v0.2.0)oder @xpayr/mcp-server (v1.0.0) über NPM oder führen Sie Live JSON-RPC 2.0 Tool-Aufrufe aus über POST https://xpayr.com/api/mcp.