401 authentication_required
Clave Bearer ausente o invalida.
Use la clave secreta de prueba o produccion correcta en la cabecera Authorization.
Depure mas rapido
Convierta cada error de API en una accion siguiente.
La mayoria de los problemas de integracion son de autenticacion, validacion, webhook, soporte de ruta o comportamiento de sondeo. Esta guia asocia el sintoma con la solucion.
400 validation_error
Falta un campo obligatorio o es invalido.
Compruebe el importe, la moneda, la red, la URL del webhook, la direccion de billetera y el formato JSON.404 not_found
No se encontro la sesion de pago o el endpoint.
Confirme el ID de sesion y la ruta. Para el estado publico use /payments/{id}/status.409 fee_delegation_unavailable
La configuracion de delegacion de comisiones, la ruta o el soporte de red no estan activos.
Use el pago estandar con billetera o active primero la politica del comercio y la ruta compatible.Error en la entrega del webhook 422
El endpoint del comercio no devolvio un estado 2xx.
Compruebe HTTPS, el analisis del cuerpo sin procesar, la verificacion de firma, el tiempo de espera y las reglas del firewall.429 rate_limited
Demasiadas solicitudes de API autenticadas.
Espere, reintente mas tarde y evite sondear con demasiada frecuencia.Sigue bloqueado?
Envie el ID de solicitud, el endpoint, el ID de sesion, el codigo de respuesta y la carga util depurada. Nunca envie claves privadas ni secretos de webhook.
Contactar soporte Abrir documentacion de API Inspeccionar Errores JSON-RPC en el Playground MCP Depurar Firmas de Webhook 422
SDKs Oficiales en NPM (v0.2.0) y Servidor MCP Remoto
Integra Más Rápido con los Paquetes Oficiales de XPayr y MCP sin Instalación
Instala @xpayr/node-sdk (v0.2.0), @xpayr/payment-evidence (v0.2.0), @xpayr/extension-kit (v0.2.0)o @xpayr/mcp-server (v1.0.0) desde NPM, o ejecuta llamadas a herramientas JSON-RPC 2.0 en vivo mediante POST https://xpayr.com/api/mcp.