Como funciona

Documentation Index

Fetch the complete documentation index at: https://docs.noxpay.io/llms.txt

Use this file to discover all available pages before exploring further.

Cada pagamento do Crossramp Checkout passa por cinco etapas. Cada transição de etapa dispara um webhook para a URL configurada.

​

Etapa 1 — Cotação

Quando um cliente abre um link de checkout, uma cotação é calculada imediatamente. A cotação trava:

• O valor em BRL que o cliente vai pagar
• O valor em cripto que você vai receber
• As taxas aplicáveis
• Uma taxa de câmbio válida por 10 minutos

Se o link não tiver um valor pré-definido, o cliente informa o valor em BRL ou cripto primeiro e a cotação é gerada a partir da sua entrada. A taxa é travada neste momento — não quando o pagamento chega.

​

Etapa 2 — Coleta de identidade (CPF/CNPJ)

Antes de um código PIX ser gerado, o cliente deve informar o seu CPF (pessoa física) ou CNPJ (empresa). O documento é validado quanto ao formato correto antes de prosseguir. Esta etapa pode ser ignorada se você pré-preencher o documento via API ao criar a sessão de checkout.

​

Etapa 3 — Verificação de identidade

O documento informado é consultado em uma base de dados de identidade brasileira. Esta etapa:

• Confirma que o documento é válido e registrado
• Cria ou recupera o perfil do cliente na Noxpay
• Bloqueia documentos irregulares antes de gerar uma cobrança PIX

Documentos empresariais (CNPJ) passam por um fluxo de validação adicional. Documentos que reprovam na verificação bloqueiam o pagamento e o cliente vê uma página de erro. Se o pagador já transacionou mais de R$ 10.000 no mês corrente, uma etapa de verificação de identidade aprimorada pode ser acionada, exigindo foto do documento e selfie.

​

Etapa 4 — Pagamento PIX

Com a identidade verificada, um QR code PIX é gerado para o valor em BRL cotado. Ele é válido até o tempo de expiração da sessão definido quando a cotação foi criada. Verificação de titularidade: Quando o pagamento PIX chega, a Noxpay verifica se o CPF do remetente PIX corresponde ao documento coletado na Etapa 2. Se forem diferentes — por exemplo, alguém paga pela conta de terceiro — a transação é marcada como UNCOMPLIANT e o pagamento fica retido para análise. Esta verificação protege contra padrões de lavagem de dinheiro em que o pagador e a identidade verificada são pessoas diferentes. A maioria dos bancos brasileiros já impõe isso no lado do remetente; esta é uma camada adicional para casos em que isso não se aplique. Um PIX que não é pago no prazo resulta em status Expired.

​

Etapa 5 — Conversão e crédito

Com o PIX confirmado e a verificação de titularidade aprovada, a Noxpay converte BRL para a criptomoeda de destino pela taxa de câmbio travada na cotação. O cripto resultante é creditado imediatamente no seu saldo disponível. O status da sessão passa para Success.

---

​

Sem integração necessária

Você pode começar a aceitar pagamentos sem escrever nenhum código. Links estáticos — criados pelo dashboard — funcionam como páginas de pagamento permanentes ou QR codes físicos. Cada visita de cliente gera uma nova sessão automaticamente.

---

​

Taxas

O cliente vê o detalhamento completo das taxas na tela de cotação antes de confirmar.

---

​

Acompanhamento de transações

Todos os checkouts aparecem em Receber → Pagamentos Recebidos. Cada linha mostra o ID da transação NOX..., o status, o timestamp, o valor em BRL pago e o valor em cripto creditado. Checkouts concluídos também aparecem como lançamentos de crédito em Conta → Extrato, com o ID NOX... vinculando ao detalhe completo da transação.