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.
Status de transação
| Status | O que significa |
|---|---|
Created | Cotação gerada, cliente ainda não enviou a identidade |
Pending | Verificação de identidade em andamento |
Processing | PIX confirmado, conversão em andamento |
Success | Cripto creditado no seu saldo |
Expired | Cliente não pagou dentro da janela da cotação |
Failed | Erro de sistema |
Cancelled | Verificação de identidade falhou ou documento inválido |
UNCOMPLIANT | CPF do remetente PIX não coincide com a identidade verificada — pagamento retido para análise |
Pagamento bem-sucedido
Cliente abre o link
O cliente abre seu link de checkout. Uma cotação é gerada imediatamente, travando o valor em BRL, o valor em cripto, a taxa e as tarifas. A taxa é válida por 10 minutos.
Cliente informa o CPF ou CNPJ
O cliente informa o CPF (pessoa física) ou CNPJ (empresa). O documento é validado quanto ao formato e depois consultado em uma base de dados de identidade brasileira. Se o documento for inválido ou reprovar na verificação, a sessão passa para
Cancelled e o cliente vê uma mensagem de erro.Cliente paga via PIX
Um QR code PIX é exibido. O cliente o escaneia no aplicativo bancário e confirma. O pagamento leva segundos do lado do cliente.
Verificação de titularidade
Quando o PIX chega, a Noxpay verifica se o CPF do remetente corresponde ao CPF coletado na etapa anterior. Se coincidirem, a sessão passa para
Processing.Cotação expira antes do cliente pagar
A janela da cotação é de 10 minutos. Se o cliente não pagar a tempo:- O QR code PIX é desativado
- A sessão passa para
Expired - Nenhum dinheiro é movido
Cliente não conclui a verificação de identidade
Se o documento do cliente reprovar na verificação — por exemplo, porque o CPF é inválido ou não está registrado — a sessão passa paraCancelled. O cliente vê uma página de erro explicando que o pagamento não pôde ser processado.
Se você criou a sessão via API e pré-preencheu o documento do cliente, pode capturar este caso via webhook e tratá-lo no seu próprio fluxo.
Divergência de titularidade — UNCOMPLIANT
Se o CPF do remetente PIX não coincidir com o CPF verificado no checkout, a sessão passa paraUNCOMPLIANT e o pagamento fica retido. Isso acontece quando alguém paga pela conta bancária de terceiro.
Entre em contato com o suporte da Noxpay com o ID de transação NOX... para resolver. Dependendo das circunstâncias, o pagamento pode ser devolvido ao remetente.