Getnet DocsGetnet Docs

Parâmetros de Resposta

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

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

ChaveTipoDescrição
TICKET_IMAGEStringURL do PDF gerado com o comprovante certificado.
AUTORIZATION_NUMBERStringNúmero de autorização.
IDENTIFIER_RTSStringIdentificador da transação.
ORDERStringNúmero do pedido.
STATEStringCódigo de resultado.
ERROR_MSGStringDescrição do erro.

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

Depois de uma consulta

ChaveTipoDescrição
TICKET_IMAGEStringURL do PDF gerado com o comprovante certificado.
STATEStringCódigo de resultado.
ERROR_MSGStringDescrição do erro.

Depois de uma devolução

ChaveTipoDescrição
TICKET_IMAGEStringURL do PDF gerado com o comprovante certificado.
STATEStringCódigo de resultado.
ERROR_MSGStringDescriçã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étodoVersão do AndroidDescrição
Extra TICKET_IMAGE< Android QCaminho do arquivo para o PDF do recibo armazenado no dispositivo.
intent.getData()≥ Android QURI de conteúdo para acessar o PDF do recibo. Requer FLAG_GRANT_READ_URI_PERMISSION.

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

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

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

Recursos Relacionados