> ## 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.

# Fluxos

> A jornada completa de pagamento — o que acontece em cada etapa, para pagamentos bem-sucedidos, expirados e não conformes.

## 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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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`.
  </Step>

  <Step title="Conversão e crédito">
    A Noxpay converte o valor em BRL para o cripto de destino pela taxa de câmbio travada. O cripto é creditado no seu saldo disponível. A sessão passa para `Success` e um webhook é enviado para a URL configurada.
  </Step>
</Steps>

***

## 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

Quando o cliente atualiza a página, uma nova cotação é gerada automaticamente com uma taxa atualizada. Ele pode continuar de onde parou sem precisar recomeçar.

***

## 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 para `Cancelled`. 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 para `UNCOMPLIANT` 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.

<Warning>
  Não credite seu usuário nem entregue serviços apenas porque um PIX foi enviado. Sempre aguarde o status `Success`. Um pagamento que gera uma divergência de titularidade não será convertido e não creditará seu saldo.
</Warning>