Getnet DocsGetnet Docs

Gerenciamento de Recibos

Esta página explica como o aplicativo Get Mini lida com os recibos de transação (Boletas) e como o seu aplicativo pode acessá-los e exibi-los.

O Ticket Certificado (Boleta)

A conformidade com os regulamentos das bandeiras de cartão exige que o recibo gerado para uma transação seja certificado e validado pela Getnet. Para garantir essa integridade, o próprio aplicativo Get Mini gera o PDF final do recibo.

O recibo em PDF fornecido pelo aplicativo Get Mini é o documento oficial certificado. Você não deve tentar modificar o seu conteúdo, pois isso pode violar os requisitos de conformidade.

Recuperando o Recibo

O caminho ou URI para o PDF gerado é retornado no Intent de resposta após uma transação bem-sucedida. O método para acessar este arquivo depende da versão do Android do dispositivo. No Android Q (API 29) e mais recentes, o URI é fornecido via intent.getData() e os arquivos são armazenados no diretório público “Documents” do dispositivo. Em dispositivos mais antigos, o caminho do arquivo é fornecido no extra TICKET_IMAGE como uma String apontando para a memória interna.

Exibindo e Compartilhando

Depois de ter o URI ou o caminho do arquivo do recibo, você pode usar um Intent padrão do Android para abrir o PDF no aplicativo de visualização preferido do usuário. O usuário pode então visualizar, imprimir ou compartilhar o recibo por e-mail ou aplicativos de mensagens. Você também pode fornecer uma opção de compartilhamento diretamente no seu aplicativo para permitir que os usuários enviem o recibo por vários canais.

Sempre verifique a versão do Android para determinar o método correto de acesso ao recibo. Use FLAG_GRANT_READ_URI_PERMISSION ao abrir ou compartilhar recibos no Android Q e superior.

Disponibilidade de Recibos

Os recibos são gerados para todas as transações bem-sucedidas, incluindo pagamentos, estornos e consultas. O URI ou caminho do recibo é incluído no Intent de resposta quando o código de resultado é RESULT_OK. Se uma transação falhar, nenhum recibo será gerado.

Não tente modificar o conteúdo do PDF, pois ele é um documento de conformidade certificado. Considere armazenar em cache ou salvar o URI do recibo se os usuários precisarem acessá-lo mais tarde.