Visão Geral da API

PayerScan é um gateway de pagamento em criptomoedas automatizado que verifica transações em múltiplas redes blockchain (EVM, Tron, Solana) e se integra diretamente com 8 grandes exchanges globais — permitindo que comerciantes aceitem pagamentos crypto com verificação em tempo real, correspondência automática e notificações de liquidação instantâneas.

Funcionalidades

• Criação de fatura: Abra uma transação via API REST, retornando um link completo da interface de checkout.
• Verificação multi-cadeia: Escaneia automaticamente transações nas redes blockchain populares — BNB Smart Chain (BEP20), Ethereum (ERC20), Base, Polygon, Arbitrum, Optimism, Tron (TRC20) — e transferências internas via Binance Pay / OKX UID,....
• Integração com exchanges: Conexão API direta com 8 grandes exchanges de criptomoedas — Binance, OKX, Bybit, Bitget, Gate, MEXC, Upbit, Bitkub — para feeds de preços em tempo real e verificação de pagamentos.
• Suporte multi-moeda: Aceite pagamentos em múltiplos tokens — USDT, USDC, BNB, ETH e mais — em todas as redes suportadas.
• Expiração automática: Faturas expiram automaticamente após um período configurável, garantindo que solicitações de pagamento obsoletas sejam tratadas adequadamente.
• Correspondência exata de valor: Elimina erros de arredondamento JS com precisão BigInt.
• Callbacks inteligentes: Notifica proativamente os comerciantes via Webhook (callback_url) quando o pagamento é concluído ou expirado, com mecanismo automático de nova tentativa (5 tentativas).
• Idempotência: Enviar o mesmo request_id retorna a fatura existente em vez de criar uma duplicata, garantindo lógica de retry segura.
• Limitação de taxa: Throttling de requisições em múltiplas camadas protege a API contra abusos e garante uso justo entre todos os comerciantes.
• Deduplicação: Impede que um único hash de transação (txHash) seja usado para liquidar múltiplas faturas.
• Notificações em tempo real: Alertas de pagamento instantâneos via Telegram, Lark ou Email para manter os comerciantes informados.
• Checkout personalizável: Múltiplos temas de checkout disponíveis, permitindo que comerciantes adaptem a página de pagamento à identidade da sua marca.

📖 Para detalhes sobre redes e exchanges suportadas, consulte o Guia de Redes & Exchanges.

Componentes principais do sistema

Para começar, navegue até as seguintes seções:

1. Início rápido: Execute um pagamento de teste em apenas 10 minutos.
2. Autenticação: Como gerenciar e usar chaves API.
3. Criar fatura: Detalhes da estrutura de dados POST.
4. Consultar fatura: Consultar status da fatura e detalhes do pagamento.
5. Eventos Webhook: Escute o status de conclusão.
6. Códigos de erro: Lista completa de códigos de erro da API e seus significados.
7. Limites de taxa: Políticas de limitação e throttling de requisições.
8. Exemplos de código: Amostras de integração prontas para uso.