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. Presente para transações aprovadas. |
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.
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 < 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. |
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.
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 - Guia completo sobre o processamento de respostas de transações.
- Parâmetros de Requisição - Referência de parâmetros de requisição.
- Estornar um Pagamento - Usando ORDER para estornos.