Preloader
XXX PAY
Docs públicas da API Guia para seller integrar autenticação, PIX, saldo e callbacks.
Voltar para o site Criar conta
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
Visão geral

O que você precisa antes de começar a integrar.

A integração da XXXPay funciona melhor quando o seller já separa credenciais, callback HTTPS e uma estratégia de identificadores externos antes de ir para código.

Checklist obrigatório

  • Conta XXXPay ativa com acesso ao painel.
  • Credencial de API gerada no menu Chaves de API.
  • Endpoint HTTPS para receber callbacks.
  • Identificador externo único por operação.
  • Integração feita no backend, nunca no frontend.

Recomendado para produção

  • Salvar o payload bruto dos webhooks para auditoria.
  • Tratar PENDING, PROCESSING, COMPLETED e FAILED.
  • Responder o webhook com HTTP 200 rapidamente e processar o resto em fila.
  • Rejeitar callbacks sem assinatura válida.

Fluxo operacional da XXXPay

1

Seller cria a credencial

A credencial nasce no painel e precisa ficar guardada no backend do seller.

2

Backend faz login na API

O Bearer token é obtido via POST /api/auth/login.

3

Backend gera a cobrança ou saque

O seller envia valor, identificador externo, callback e dados necessários da operação.

4

XXXPay atualiza o seller por webhook

Os eventos saem assinados, com timestamp e HMAC usando o client secret da conta.

Item Valor Observação
Base da API https://api.xxxpay.online/api Use sempre HTTPS.
Login POST /auth/login Retorna o Bearer token.
Cobranca PIX POST /payments/deposit Fluxo principal de PIX In.
Saque PIX POST /withdrawals/withdraw Fluxo principal de PIX Out.
Saldo GET /users/balance Usa os headers ci e cs.
Voltar para a capa Próximo: credenciais e login