401 authentication_required
Cle Bearer manquante ou invalide.
Utilisez la bonne cle secrete de test ou de production dans l'en-tete Authorization.
Deboguer plus vite
Transformez chaque erreur d'API en action suivante.
La plupart des problemes d'integration relevent de l'authentification, de la validation, des webhooks, du support de route ou du polling. Ce guide associe le symptome au correctif.
400 validation_error
Champ obligatoire manquant ou invalide.
Verifiez le montant, la devise, le reseau, l'URL du webhook, l'adresse du portefeuille et le format JSON.404 not_found
Session de paiement ou point de terminaison introuvable.
Verifiez l'ID de session et le chemin de route. Pour le statut public, utilisez /payments/{id}/status.409 fee_delegation_unavailable
Les parametres de delegation de frais, la route ou le support reseau ne sont pas actifs.
Utilisez le paiement standard par portefeuille ou activez d'abord la politique marchand et la route prise en charge.Échec de la livraison du webhook 422
Le point de terminaison marchand n'a pas renvoye un statut 2xx.
Verifiez HTTPS, l'analyse du corps brut, la verification de signature, le delai d'attente et les regles de pare-feu.429 rate_limited
Trop de requetes API authentifiees.
Patientez, reessayez plus tard et evitez un polling trop frequent.Toujours bloque ?
Envoyez l'ID de requete, le point de terminaison, l'ID de session, le code de reponse et la charge utile nettoyee. N'envoyez jamais de cles privees ni de secrets de webhook.
Contacter le support Ouvrir la documentation API Inspecter les Erreurs JSON-RPC dans le Playground MCP Déboguer les Signatures Webhook 422
SDK NPM Officiels (v0.2.0) et Serveur MCP Distant
Intégrez Plus Vite avec les Paquets Officiels XPayr et MCP sans Installation
Installez @xpayr/node-sdk (v0.2.0), @xpayr/payment-evidence (v0.2.0), @xpayr/extension-kit (v0.2.0)ou @xpayr/mcp-server (v1.0.0) depuis NPM, ou exécutez des appels d'outils JSON-RPC 2.0 en direct via POST https://xpayr.com/api/mcp.