401 authentication_required
Chave Bearer ausente ou invalida.
Use a chave secreta de teste ou producao correta no cabecalho Authorization.
Depure mais rapido
Transforme cada erro de API em uma proxima acao.
A maioria dos problemas de integracao envolve autenticacao, validacao, webhook, suporte de rota ou comportamento de polling. Este guia liga o sintoma a correcao.
400 validation_error
Campo obrigatorio ausente ou invalido.
Verifique valor, moeda, rede, URL do webhook, endereco da carteira e formato JSON.404 not_found
Sessao de pagamento ou endpoint nao encontrado.
Confirme o ID da sessao e o caminho da rota. Para status publico use /payments/{id}/status.409 fee_delegation_unavailable
Configuracoes de delegacao de taxa, rota ou suporte de rede nao estao ativos.
Use o checkout padrao com carteira ou ative primeiro a politica do lojista e a rota suportada.422 falha na entrega do webhook
O endpoint do lojista nao retornou um status 2xx.
Verifique HTTPS, analise do corpo bruto, verificacao de assinatura, tempo limite e regras de firewall.429 rate_limited
Solicitacoes de API autenticadas em excesso.
Aguarde, tente novamente mais tarde e evite fazer polling com muita frequencia.Ainda travado?
Envie o ID da requisicao, endpoint, ID da sessao, codigo de resposta e payload sanitizado. Nunca envie chaves privadas ou segredos de webhook.
Falar com o suporte Abrir documentacao da API Inspecionar Erros JSON-RPC no Playground MCP Depurar Assinaturas de Webhook 422
SDKs Oficiais no NPM (v0.2.0) e Servidor MCP Remoto
Integre Mais Rápido com Pacotes Oficiais da XPayr e MCP sem Instalação
Instale @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) pelo NPM, ou execute chamadas de ferramentas JSON-RPC 2.0 ao vivo via POST https://xpayr.com/api/mcp.