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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.criptonopix.app.br/docs/cripto-no-pix-partner-api/webhook/status-das-transacoes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
