Pular para o conteúdo principal

Introdução ao PayerScan

PayerScan permite que comerciantes integrem pagamentos em criptomoeda (USDT, BNB, ETH, etc.) em seus sites ou aplicações. Os clientes pagam com carteiras crypto ou contas de exchange, e o sistema verifica automaticamente as transações e notifica o comerciante via API e Webhooks.

Funcionalidades Principais​

  • Criar faturas de pagamento via API com valor (USD), expiração, URL de callback.
  • Página de checkout exibindo QR code, endereço da carteira e a quantidade exata de crypto a transferir.
  • Multi-rede — suporte a múltiplos métodos de pagamento:
    • Cadeias EVM: BSC, Ethereum, Polygon, Base, Arbitrum, ...
    • Tron: Tokens TRC20
    • Solana: Tokens SPL
    • Plataformas de câmbio: Binance Pay, OKX, Bybit, MEXC, Gate.io, Bitget, ... (sem taxas de gas, confirmação instantânea)
  • Confirmação automática quando uma transação correspondente é detectada (endereço correto, valor correto, dentro da janela de tempo).
  • Webhooks para notificar o servidor do comerciante sobre pagamento bem-sucedido ou expiração de fatura.
  • API de consulta de status de faturas por trans_id.

Fluxo de Trabalho​

  1. Criar fatura — Comerciante chama POST /payment/crypto com merchant_id, amount, callback_url, e recebe trans_id + url_payment.
  2. Redirecionar cliente — Comerciante redireciona o cliente para url_payment (a página de checkout).
  3. Cliente paga — Cliente seleciona token/rede, depois transfere o valor exato para o endereço de carteira exibido (ou paga via plataforma de câmbio).
  4. Confirmação automática — Sistema detecta e verifica a transação → atualiza a fatura para completed → envia um POST webhook para o callback_url do comerciante.
  5. Fatura expirada — Se o cliente não pagar dentro da janela de tempo, o status da fatura muda para expired e um webhook também é enviado para o callback_url.
  6. Verificar status — Comerciante pode chamar GET /invoice/:trans_id para verificar o status atual a qualquer momento.

Requisitos de Integração​

  • API Key: Cada loja tem uma API Key, enviada via header x-api-key em cada requisição.
  • Método de pagamento: Pelo menos um endereço de carteira ou plataforma de câmbio deve ser configurado na sua loja antes de criar faturas.
  • URL de Callback: Uma URL HTTPS pública onde o servidor do comerciante recebe eventos POST (webhook) para faturas completed/expired.
  • HTTPS: A API PayerScan usa exclusivamente HTTPS. URLs de callback também devem usar HTTPS para garantir transmissão segura de dados.

Próximos Passos​