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
Consulta de transacao

Verifique o status de uma transação usando o identificador retornado pela XXXPay.

Esta rota atende o seller que precisa conciliar pagamentos e saques no próprio backend. Para cobranças criadas em /api/payments/deposit, use o transactionId retornado na resposta da XXXPay. A autenticação é feita com ci e cs.

POST https://api.xxxpay.online/api/transactions/check
curl --request POST 'https://api.xxxpay.online/api/transactions/check' \
  --header 'Content-Type: application/json' \
  --header 'ci: seu_client_id' \
  --header 'cs: seu_client_secret' \
  --data '{
    "transactionId": "pedido-1001"
  }'
{
  "message": "Transacao encontrada com sucesso!",
  "transaction": {
    "transactionId": "pedido-1001",
    "value": 25.9,
    "fee": 0.5,
    "transactionState": "COMPLETO",
    "transactionType": "DEPOSITO",
    "transactionMethod": "PIX",
    "createdAt": "2026-04-09T12:10:00.000Z",
    "updatedAt": "2026-04-09T12:10:15.000Z",
    "rawStatus": "COMPLETED"
  }
}
Campo Significado
transactionState PENDENTE, COMPLETO ou FALHA.
transactionType DEPOSITO, RETIRADA ou TRANSFERENCIA_INTERNA.
rawStatus Status interno mais detalhado quando disponível.