# Parâmetros de Resposta

Esta referência documenta todos os parâmetros retornados pelo aplicativo Get Mini após uma tentativa de transação. Quando a operação termina, ela retorna um Intent para o retorno de chamada (callback) `ActivityResult` do seu aplicativo com os detalhes da transação armazenados como extras.

## Acessando os Dados de Resposta

Os parâmetros de resposta são recuperados do Intent usando os métodos `getStringExtra()` ou `getIntExtra()` com as chaves de parâmetro listadas abaixo. Todas as chaves diferenciam maiúsculas de minúsculas (case-sensitive) e devem corresponder exatamente.

## Parâmetros de resposta por operação

O app Get Mini devolve um conjunto de extras diferente para cada operação. Leia as chaves da operação que você disparou. Todas diferenciam maiúsculas de minúsculas.

### Depois de um pagamento

| Chave | Tipo | Descrição |
| :---- | :---- | :---- |
| `TICKET_IMAGE` | String | URL do PDF gerado com o comprovante certificado. |
| `AUTORIZATION_NUMBER` | String | Número de autorização. |
| `IDENTIFIER_RTS` | String | Identificador da transação. |
| `ORDER` | String | Número do pedido. |
| `STATE` | String | Código de resultado. |
| `ERROR_MSG` | String | Descrição do erro. |

<Callout type="warning">

A chave de autorização é escrita `AUTORIZATION_NUMBER`, sem o 'H'. Use exatamente essa string.

</Callout>

### Depois de uma consulta

| Chave | Tipo | Descrição |
| :---- | :---- | :---- |
| `TICKET_IMAGE` | String | URL do PDF gerado com o comprovante certificado. |
| `STATE` | String | Código de resultado. |
| `ERROR_MSG` | String | Descrição do erro. |

### Depois de uma devolução

| Chave | Tipo | Descrição |
| :---- | :---- | :---- |
| `TICKET_IMAGE` | String | URL do PDF gerado com o comprovante certificado. |
| `STATE` | String | Código de resultado. |
| `ERROR_MSG` | String | Descrição do erro. |

## Acesso aos Recibos

Os métodos de acesso aos recibos variam de acordo com a versão do Android. O aplicativo Get Mini fornece mecanismos diferentes para acessar os recibos das transações:

| Método | Versão do Android | Descrição |
| :---- | :---- | :---- |
| Extra `TICKET_IMAGE` | &lt; Android Q | Caminho do arquivo para o PDF do recibo armazenado no dispositivo. |
| `intent.getData()` | ≥ Android Q | URI de conteúdo para acessar o PDF do recibo. Requer `FLAG_GRANT_READ_URI_PERMISSION`. |

<Callout type="note">

Para o Android Q e superior, use `intent.getData()` para recuperar o URI do recibo em vez do extra `TICKET_IMAGE`.

</Callout>

## Valores de Estado

`STATE` traz o código de resultado da operação e, quando a operação é negada, o código de negação.

Consulte [Códigos de resultado e erros](/pt/get-mini/get-mini-app2app/reference/result-codes-and-errors) para saber como lê-lo.

## Práticas Recomendadas para o Tratamento de Dados

Ao processar os parâmetros de resposta, siga estas diretrizes para garantir um tratamento robusto da transação:

* **Verificar os dados do Intent** - Sempre verifique se o Intent não é nulo antes de extrair os parâmetros
* **Verificar o STATE primeiro** - Sempre verifique o parâmetro `STATE` antes de processar outros campos
* **Armazenar campos críticos** - Salve `AUTORIZATION_NUMBER`, `ORDER` e `IDENTIFIER_RTS` para todas as transações bem-sucedidas
* **Lidar com campos ausentes** - Nem todos os parâmetros estão presentes em todas as respostas. Verifique se há valores nulos antes de usar strings
* **Adicionar carimbos de data/hora (timestamps)** - Armazene seu próprio carimbo de data/hora ao registrar dados de transações para uma conciliação precisa
* **Gerenciar recibos** - Lide com os métodos de caminho de arquivo e URI, dependendo da versão do Android

<Callout type="warning">

O parâmetro `ORDER` deve ser armazenado para transações de pagamento bem-sucedidas, pois é necessário para processar estornos.

</Callout>

## Recursos Relacionados

* [Lidar com os resultados da transação](/pt/get-mini/get-mini-app2app/transaction-guides/response-handling/handle-transaction-results) - Guia completo sobre o processamento de respostas de transação
* [Parâmetros de solicitação](/pt/get-mini/get-mini-app2app/reference/request-parameters) - Referência de parâmetros de solicitação
* [Códigos de resultado e erros](/pt/get-mini/get-mini-app2app/reference/result-codes-and-errors) - Referência completa de códigos de erro