# Parâmetros de Resposta

Esta referência documenta todos os parâmetros retornados pela aplicação Get Smart após uma tentativa de transação. Quando a atividade de pagamento termina, ela retorna um Intent para o método `onActivityResult` da sua aplicação com os detalhes da transação armazenados como extras.

## Acessando 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âmetros listadas abaixo. Todas as chaves diferenciam maiúsculas de minúsculas e devem corresponder exatamente.

## Parâmetros de Resposta Comuns

Os seguintes parâmetros são retornados para todos os tipos de transação. Estes campos fornecem informações essenciais sobre o desfecho da transação, detalhes da autorização e o método de pagamento utilizado.

| Chave do Parâmetro | Tipo | Sempre Presente | Descrição |
| :---- | :---- | :---- | :---- |
| `RESULT` | String | Sim | Desfecho da transação. Valores: `"AUTORIZADA"` (aprovada) ou `"DENEGADA"` (negada). |
| `RESPCODE` | int | Sim | Código de resposta indicando o motivo específico para o desfecho da transação. Use `-1` como valor padrão ao extrair para distinguir do código `0`. |
| `ERROR_MSG` | String | Condicional | Motivo da denegação ou erro legível por humanos. Presente quando a transação é negada ou encontra um erro. |
| `AUTORIZATION_NUMBER` | String | Condicional | Código de autorização atribuído pelo banco. Presente apenas para transações aprovadas. Note a grafia (falta o 'H'). |
| `IDENTIFIER_RTS` | String | Sim | Identificador exclusivo da transação atribuído pelo sistema Get Smart. |
| `ORDER` | String | Sim | Número do pedido associado à operação. Necessário para operações de estorno como o parâmetro `original_order`. |
| `CARDBRAND` | String | Condicional | Bandeira do cartão usado para o pagamento. Veja [Bandeiras de Cartão](#bandeiras-de-cartão). Presente para transações aprovadas. |

<Callout type="warning">

A chave do número de autorização é grafada como `"AUTORIZATION_NUMBER"` (sem o 'H'). Você deve usar esta string exata como chave para recuperar o valor.

</Callout>

## Parâmetros de Resposta Específicos por Transação

Dependendo do tipo de transação, parâmetros adicionais podem ser incluídos na resposta. A tabela a seguir lista campos específicos da operação que podem estar presentes.

| Chave do Parâmetro | Tipo | Tipos de Transação | Descrição |
| :---- | :---- | :---- | :---- |
| `AUTHORIZATION` | String | Todas as transações bem-sucedidas | Chave alternativa para o código de autorização. Alguns tipos de transação podem retornar isso em adição ou em vez de `AUTORIZATION_NUMBER`. |
| `TICKET_IMAGE` | String | Transações bem-sucedidas (Android &lt; Q) | Caminho do arquivo para a imagem do comprovante para dispositivos com versões do Android anteriores à Q. |
| `TICKET_DATA` | Uri | Transações bem-sucedidas (Android ≥ Q) | URI de conteúdo para acessar o PDF do comprovante no Android Q e superior. Requer `FLAG_GRANT_READ_URI_PERMISSION`. |

<Callout type="note">

Os métodos de acesso ao comprovante variam de acordo com a versão do Android. Para o Android Q e superior, use `intent.getData()` para recuperar o URI do comprovante. Para versões anteriores, use o extra `TICKET_IMAGE` para obter o caminho do arquivo.

</Callout>

## Valores de Resposta

### Valores de Resultado

O parâmetro `RESULT` indica o desfecho final da transação. Verifique sempre este valor primeiro para determinar se a transação foi bem-sucedida.

| Valor | Significado | Descrição |
| :---- | :---- | :---- |
| `"AUTORIZADA"` | Autorizada | O pagamento foi aprovado com sucesso pelo gateway de pagamento. |
| `"DENEGADA"` | Negada | O pagamento foi rejeitado ou falhou. |

### Bandeiras de Cartão

O parâmetro `CARDBRAND` retorna a rede do cartão utilizado para o pagamento. Esta informação é útil para comprovantes, análises e rastreamento de preferências de métodos de pagamento.

| Valor | Rede do Cartão |
| :---- | :---- |
| `"VISA"` | Visa |
| `"MASTERCARD"` | Mastercard |
| `"DINERS"` | Diners Club |
| `"AMEX"` | American Express |
| `"JCB"` | JCB |
| `"CUP"` | China UnionPay |

## Valores de Código de Resposta

O parâmetro `RESPCODE` fornece códigos de motivo específicos para os desfechos das transações, sendo particularmente útil para transações negadas. Os valores dos códigos de resposta variam de acordo com o gateway de pagamento e o emissor do cartão. As categorias comuns incluem:

* **Saldo insuficiente** - O cliente não possui saldo suficiente.
* **Cartão expirado** - A data de validade do cartão passou.
* **Cartão inválido** - O número do cartão ou os detalhes estão incorretos.
* **Cartão restrito** - O cartão foi bloqueado ou reportado.
* **Erros técnicos** - Problemas de gateway ou de comunicação.

Para transações aprovadas, o código de resposta é tipicamente `0`. Para transações negadas, consulte o suporte da Get Smart para significados de códigos específicos relevantes para a configuração do seu estabelecimento.

## Recursos Relacionados

* [Tratar Resultados de Transação](/pt/get-smart/get-smart-app2app/transaction-guides/transactions/handle-transaction-results) - Guia completo sobre o processamento de respostas de transações.
* [Parâmetros de Requisição](https://docs.globalgetnet.com/pt/products/local-processor-spain/get-smart-app2app?doc=getsmart-app2app-request-reference) - Referência de parâmetros de requisição.
* [Estornar um Pagamento](/pt/get-smart/get-smart-app2app/transaction-guides/transactions/refund-a-payment) - Usando ORDER para estornos.