> For the complete documentation index, see [llms.txt](https://docs.criptonopix.app.br/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.criptonopix.app.br/docs/cripto-no-pix-partner-api/webhook/status-das-transacoes.md).

# Status das transações

O envio dos webhooks  de todas as partes necesárias da transação será enviado no endpoint fornecido no momento do cadastro do parceiro.

#### Detalhes dos status de transação.

Abaixo estão os tipos utilizados para definir o status, tipo e possíveis erros relacionados a uma transação. Eles são essenciais para o controle e entendimento do fluxo de uma operação dentro do sistema.

`transactionType`

Define o **tipo da transação**. Pode ser:

* `PIX_PURCHASE`: Ordem de compra via Pix.
* `CRYPTO_PURCHASE`: Compra via cripto.
* `PIX_WITHDRAW`: Ordem de saque via Pix.
* `CRYPTO_WITHDRAW`: Saque via cripto.

`transactionStatus`

Define o **status atual da transação**. Os valores possíveis são:

* `CREATED`: Transação criada.
* `WAITING_PAYMENT`: Aguardando pagamento.
* `PAID`: Pagamento confirmado.
* `PROCESSING`: Transação em processamento.
* `RETRYING`: Tentando novamente após falha.
* `COMPLETED`: Transação concluída com sucesso.
* `REFUNDED`: Valor reembolsado.
* `ERROR`: Transação com erro.

`transactionErrorType`

Define o **tipo do erro ocorrido**, caso exista. Os valores possíveis são:

* `NONE`: Sem erro.
* `DIVERGENT_PAYER`: Pagador divergente.
* `DIVERGENT_RECEIVER`: Recebedor divergente.
* `BLOCKCHAIN_ERROR`: Erro relacionado à blockchain.
* `TRANSACTION_NOT_FOUND`: Transação não encontrada.
* `REFUNDED_BY_ERROR`: Reembolso causado por erro.
* `MISSING_REFUND_USER`: Falha no reembolso após um erro.

`transactionErrorMessage`

Define a **mensagem descritiva do erro**, oferecendo mais contexto. Pode conter:

* `NONE`: Nenhuma mensagem de erro.
* `Divergent payer`: O pagador é diferente do esperado.
* `Divergent receiver`: O recebedor é diferente do esperado.
* `Blockchain error`: Erro na execução da transação na blockchain.
* `Transaction not found`: Transação não localizada.
* `Max attempts reached`: Número máximo de tentativas excedido.
* `Refunded by error`: Reembolsada por conta de erro.
* `Missing refund user`: Falh no reembolso após um erro ou divergência.