Preloader
XXX PAY
Docs públicas da API Guia para seller integrar autenticação, PIX, saldo e callbacks.
Guia do seller

Integre rápido, teste com clareza e publique com segurança.

Organizamos a documentação para você sair da credencial até o callback sem se perder no caminho.

Ativo hoje na XXXPay

  • PIX In com QR Code e copia e cola
  • PIX Out com callback de status
  • Consulta de saldo e transação
Criar conta na XXXPay
Erros e tratamento

Como o seller deve reagir aos erros mais comuns.

Erros que exigem ajuste imediato

  • Payload obrigatório ausente.
  • Callback sem HTTPS.
  • Valor abaixo do mínimo operacional.
  • Chave PIX ou tipo de chave inválido.

Erros que pedem retry controlado

  • 429 por rate limit.
  • 500/502 por indisponibilidade transitória.
  • Timeout de rede entre seller e XXXPay.
{
  "message": "O valor minimo para saque na XXXPay e de R$ 10,00."
}

Regra simples para retry

Se o erro for de validação, corrija antes de tentar de novo. Se for operacional, use backoff exponencial com limite de tentativas.