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
Checklist de producao

Boas práticas para colocar a integração no ar com segurança.

1

Use identificadores externos unicos

Não reaproveite external_id entre operações diferentes.

2

Guarde o corpo bruto do webhook

A validação HMAC precisa do raw body, sem alteração de espaços ou ordenação.

3

Responda rapido

Devolva HTTP 200 e processe side effects em fila para evitar timeout desnecessario.

4

Implemente idempotencia

Se o mesmo callback chegar duas vezes, o seller precisa ignorar reprocessamento financeiro.

5

Monitore 401, 403, 429 e 500

Esses códigos são os mais importantes para alerta, retry e reautenticação.