Release Notes Integração SDK Android SC3

Versão 3.6.0

Modelo de terminais compatíveis: GPOS700, GPOS700MINI, GPOS700X, GPOS720, GPOS760 e GPOS780 da Gertec, A8 e DX8000 da Ingenico, Smartphone, N910 da Newland, A910 e A920 da Pax, e X990 da Verifone.

Descrição da Versão:

• Adicionado o novo código de resposta "113" nas transações de Carteira Digital para remover o QR Code exibido na tela e permitir a continuidade da operação.
• Implementado o porte do SDK Transaction para o novo modelo GPOS780 da Gertec.
• Adicionado o novo código de resposta "403", permitindo que a integração exiba ou oculte a mensagem genérica de "Erros detectados internamente" em casos de erro no fluxo transacional.
• Automatizada a compilação das dependências GSurf do SDK Transaction (Desenv, Homolog e Prod) via Pipeline do GitLab nos merges requests para release.
• Corrigida a vulnerabilidade identificada pelo Dependency Scanning no projeto após a atualização da dependência Apache Commons Lang para a versão 3.18.0.
• Atualizadas as versões do Android SDK no projeto para garantir compatibilidade com a versão 15 do Android em Smartphones.

Versão 3.5.0

Modelo de terminais compatíveis: GPOS700, GPOS700MINI, GPOS700X, GPOS720 e GPOS760 da Gertec, A8 e DX8000 da Ingenico, Smartphone, N910 da Newland, A910 e A920 da Pax, e X990 da Verifone.

Descrição da Versão:

• Ajustado o porte do SDK Transaction para o modelo DX8000 da Ingenico.
• Realizada a atualização de versão da Lib bcapos, da anterior (5.16) para a atual (6.18), ao modelo de terminal DX8000.
• Realizada a atualização de versão da Lib dm-apos, da anterior (1.7.1) para a atual (2.1.0), ao modelo de terminal DX8000.
• Realizada a atualização de versão da Lib usdk_api_aidl, da anterior (13.5.10TC.20220331) para a atual (13.5.12TB.20220520), ao modelo de terminal DX8000.
• Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.117.60.rc3) para a atual (7.0.117.88.r1), ao modelo de terminal DX8000.

Versão 3.4.0

Modelo de terminais compatíveis: GPOS700, GPOS700MINI, GPOS700X, GPOS720 e GPOS760 da Gertec, A8 da Ingenico, Smartphone, N910 da Newland, A910 e A920 da Pax, e X990 da Verifone.

Descrição da Versão:

• Implementado o porte do SDK Transaction para o novo modelo GPOS760 da Gertec
• Tratado para que seja retornado um erro caso a integração envie um dado vazio ou zero no fornecimento do número de parcelas, utilizando o código de resposta "105" em transações de crédito parcelado.
• Corrigida a vulnerabilidade identificada pelo Dependency Scanning no projeto após a atualização da dependência Apache Commons IO para a versão 2.17.0.
• Realizada a atualização de versão da Lib Payment (GEDI), da anterior (1.16.14.1) para a atual (1.16.15.2), ao modelo de terminal GPOS700X.

Versão 3.3.0

Modelo de terminais compatíveis: GPOS700, GPOS700MINI, GPOS700X e GPOS720 da Gertec, A8 da Ingenico, Smartphone, N910 da Newland, A910 e A920 da Pax e X990 da Verifone.

Descrição da Versão:

• Realizada a ofuscação do código e a remoção dos logs da Lib SDK Transaction em modo release, bem como disponibilizada a versão da mesma em modo debug.
• Implementada a coleta da informação de versão da Lib SDK Transaction através da propriedade "sdkVersion" da nova classe "GsurfSDKData".
• Realizada a atualização de versões de compilação do Android SDK ("targetSdkVersion" e "compileSdkVersion"), da versão de API anterior "33" para a atual "34", de modo a atender a Lib SDK Transaction ao modelo Smartphone compatível com a versão 14 do Android.
• Tratados todos os warnings e vulnerabilidades identificadas pelo SAST no projeto.
• Tratados todos os warnings identificados durante a compilação da Lib SDK Transaction.
• Removidas as extensões descontinuadas do Kotlin do Android após realizadas as atualizações do Plugin do Gradle e do Kotlin no projeto.
• Realizadas as atualizações necessárias de modo à possibilitar a compilação da Lib SDK Transaction utilizando o Java (OpenJDK) na versão 17, e tratadas todas as vulnerabilidades identificados pelo Dependency Scanning no projeto.
• Implementada a coleta da informação de versão da Lib CliSiTef através da propriedade "cliSiTefVersion" da nova classe "GsurfSDKData".
• Realizada a atualização de versão da Lib NeptuneLiteApi, da anterior (4.03.00) para a atual (4.04.00), aos modelos de terminais A910 e A920.
• Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.117.82.r2) para a atual (7.0.117.88.r1), aos modelos de terminais A910 e A920.
• Incluído o arquivo de configuração da biblioteca compartilhada da Pax, que corrige o problema na leitura do cartão por chip ou contactless em transações de crédito utilizando as adquirentes Rede, Vero, Adiq, PagSeguro e Bin nos modelos A910 e A920.
• Ajustadas as informações referentes à forma de pagamento da transação no envio e reenvio eletrônico do comprovante por SMS.
• Implementada a possibilidade de configuração do CupomFiscal da CliSiTef como parâmetro em JSON na função de requisição de Venda Acumulativa, bem como as suas tratativas caso o dado seja passado em branco ou ultrapasse os 20 caracteres permitidos, além de manter o uso do último CupomFiscal configurado para o tratamento de pendências.
• Implementado o porte do SDK Transaction para o novo modelo X990 da Verifone.
• Realizada a atualização de versão da Lib PPComp, da anterior (1.29.8.200623) para a atual (001.35.230609), aos modelos de terminais GPOS700 e GPOS700X.
• Realizada a atualização de versão da Lib Payment (GEDI), da anterior (1.14.15.3) para a atual (1.16.14.1), aos modelos de terminais GPOS700 e GPOS700X.
• Adicionada a anotação de deprecated na função de requisição de Venda "requestSale()", visto que para este tipo de transação deve ser utilizada a função de requisição atual de Venda Acumulativa "initTransaction()".
• Realizada a atualização de versão da Lib PPComp, da anterior (1.29.14.210610) para a atual (001.44.231109), ao modelo de terminal GPOS700MINI.
• Realizada a atualização de versão da Lib Payment (GEDI), da anterior (1.14.15.3) para a atual (1.16.22), ao modelo de terminal GPOS700MINI.
• Tratado para que não seja exigido o aceite da permissão de "WRITE_EXTERNAL_STORAGE" durante a ativação do novo usuário em dispositivos que utilizam a versão do Android 13 ou superior.
• Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.117.91.r4) para a atual (7.0.117.93.r4), aos modelos de terminais GPOS700, GPOS700MINI e GPOS700X.

Versão 3.2.0

Modelo de terminais compatíveis: GPOS700, GPOS700MINI, GPOS700X e GPOS720 da Gertec, A8 da Ingenico, Smartphone e N910 da Newland.

Descrição da Versão:

• Implementado o porte do SDK para o novo modelo GPOS720 da Gertec.
• Implementado o controle referente à configuração máxima de parcelas da Loja no SC3, de modo com que não seja possível prosseguir com uma venda parcelada caso o número de parcelas fornecido seja superior ao configurado.
• Tratado para que o fluxo transacional não seja interrompido na ocorrência do erro de "Erro Config Email/SMS" durante o envio eletrônico do comprovante referente à via do lojista.
• Adicionado o novo código de resposta "402" que indica a ocorrência do erro de "Erro Config Email/SMS" durante o envio eletrônico do comprovante referente à via do cliente, e que requere a finalização da classe por parte da integração.
• Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.117.77.r3 de Simulado e 7.0.117.77.r2 de Produção) para a atual (7.0.117.82.r2), ao modelo de terminal Smartphone.
• Ajustada a formatação dos dados da transação no envio eletrônico do comprovante por SMS, onde o nome da loja passa a ser limitado à 15 caracteres, e caso o total de caracteres da mensagem atinja a quantidade de 150 no envio, considerando 10 caracteres reservados ao nome do template/subadquirente, passa-se a ser decrementado os caracteres excedentes ao final do comprovante, de modo com que não haja problemas no envio do mesmo por conta da limitação máxima de 160 caracteres. Observação: Importante verificar se há um nome de template/subadquirente configurado no Zenvia, caso não, deverá então ser considerado o nome presente no parâmetro "name" atribuído nas funções de requisição transacionais conforme o exemplo em Kotlin na função de venda abaixo, onde o mesmo deverá ser limitado à 10 caracteres (incluindo ": ").

gsurf.requestSale(valor = "100", name = "gsurf: ")

Versão 3.1.0

Modelo de terminais compatíveis: GPOS700, GPOS700MINI e GPOS700X da Gertec, A8 da Ingenico, Smartphone e N910 da Newland.

Descrição da Versão:

• Realizada a atualização de versão da Lib bcnewland, da anterior (228) para a atual (244), aos terminais de modelo N910, onde soluciona a ocorrência de problemas no reconhecimento de alguns cartões.
• Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.117.51.rc12) para a atual (7.0.117.65.r1), aos terminais de modelo N910
• Corrigido o erro 36 que ocorria na inicialização da aplicação de integração após a atualização de uma versão do SDK inferior à versão 2.8 para uma versão igual ou superior à versão 2.8.
• Implementado o controle de filtro do PinPad conectado via bluetooth através de seu endereço MAC a ser passado opcionalmente por parâmetro nas funções de requisição de Venda, Estorno, Reimpressão/Reenvio, Pré-Autorização, Cancelamento de Pré-Autorização, Captura de Pré-Autorização, Cancelamento de Captura de Pré-Autorização, Carteira Digital/QR Code, Cancelamento de Carteira Digital/QR Code, Verificação de Transações Pendentes, Venda Acumulativa e Venda Digitada via NFC.

Versão 3.0.0

Modelo de terminais compatíveis: GPOS700, GPOS700MINI e GPOS700X da Gertec, A8 da Ingenico e Smartphone.

Descrição da Versão:

• Realizada a atualização de versões de compilação do SDK (minSdkVersion, targetSdkVersion, compileSdkVersion e buildToolsVersion), das versões de API anteriores ("20", "32", "32" e "29.0.2", respectivamente) para as atuais ("21", "33", "33" e "30.0.3", respectivamente), de modo a atender a biblioteca SDK ao modelo Smartphone compatível com a versão 13 do Android.
• Adicionado o tratamento para não ser necessária a validação da permissão WRITE_EXTERNAL_STORAGE durante a ativação do terminal quando utilizada a versão de API "33" ou superior.
• Realizada a atualização de versões das demais dependências utilizadas no projeto do SDK, e migrado o mesmo para o AndroidX.
• Realizada a atualização de versão da CliSiTef (Simulado), da anterior (7.0.117.47.r1) para a atual (7.0.117.77.r3), aos terminais de modelo Smartphone.
• Realizada a atualização de versão da CliSiTef (Produção), da anterior (7.0.117.47.r1) para a atual (7.0.117.77.r2), aos terminais de modelo Smartphone.
• Adicionado o novo código de resposta "112" que indica mensagem de erro e requere a confirmação para que seja dado continuidade ao fluxo transacional através do método "continueOperation()".
• Adicionado o novo código de resposta "205" que indica sucesso no envio do comprovante eletrônico, sendo necessário somente a realização do contexto/sessão da classe por parte da integração.
• Corrigida a duplicidade do QR Code no fluxo de venda de Carteira Digital com Pix.

Versão 2.9

Modelo de terminais compatíveis: L200 e L300 da Positivo.

Descrição da Versão:
- Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.117.56.rc6) para a atual (7.0.117.66.rc1), aos terminais de modelos L200 e L300.
- Realizada a atualização de versão da Lib PositivoLIBSoftwareEx, da anterior (15.7.12) para a atual (15.7.18), aos terminais de modelos L200 e L300.

Versão 2.8

Modelo de terminais compatíveis: GPOS700, GPOS700MINI e GPOS700X da Gertec, A8 e DX8000 da Ingenico, Smartphone, A910 e A920 da Pax, N910 da Newland e L200 e L300 da Positivo.

Descrição da Versão:
- Realizada a atualização de versão da CliSiTef (Simulado), da anterior (7.0.117.47.r1) para a atual (7.0.117.60.rc3), aos terminais de modelo A8.
- Realizada a atualização de versão da CliSiTef (Produção), da anterior (7.0.117.47.r1) para a atual (7.0.117.63.rc2), aos terminais de modelo A8.
- Realizada a atualização de versão da Lib bcapos, da anterior (5.13) para a atual (5.16), aos terminais de modelo A8.
- Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.117.38.rc2) para a atual (7.0.117.60.rc3), aos terminais de modelo DX8000.
- Realizada a atualização de versão da Lib bcapos, da anterior (5.10) para a atual (5.16), aos terminais de modelo DX8000.
- Realizada a atualização de versão da Lib dm-apos, da anterior (1.6.1) para a atual (1.7.1), aos terminais de modelo DX8000.
- Realizada a atualização de versão da Lib usdk_api_aidl_limited, da anterior (1.0.0.20200814) para a atual (2.0.1.20210628), aos terminais de modelo DX8000.
- Realizada a atualização de versão da Lib usdk_api_aidl, da anterior (13.2.1.20210323) para a atual (13.5.10TC.20220331), aos terminais de modelo DX8000.
- Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.117.47.r1) para a atual (7.0.117.59.r1), aos terminais de modelo Smartphone.
- Realizada a atualização de versão da Lib bcnewland, da anterior (213) para a atual (228), aos terminais de modelo N910.

Versão 2.7

Modelo de terminais compatíveis: A910 e A920 da Pax, N910 da Newland e L200 e L300 da Positivo.

Descrição da Versão:

• Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.117.27.rc1) para a atual (7.0.117.56.r2), aos terminais de modelos A910 e A920.
• Realizada a atualização de versão da Lib PPCOMP, da anterior (1.55) para a atual (1.59), aos terminais de modelos A910 e A920.
• Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.117.32.rc1) para a atual (7.0.117.51.rc12), aos terminais de modelo N910.

Versão 2.6

Modelo de terminais compatíveis: A8 da Ingenico.

Descrição da Versão:

• Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.117.38.rc2) para a atual (7.0.117.47.r1), aos terminais de modelo A8 onde corrige o problema ao tentar realizar o envio dos log's.

Versão 2.5

Modelo de terminais compatíveis: A8 da Ingenico.

Descrição da Versão:

• Realizada a atualização de versão da Lib bcapos, da anterior (5.10) para a atual (5.13), aos terminais de modelo A8.

• Realizada a atualização de versão da Lib dm-apos, da anterior (1.6.1) para a atual (1.7.1), aos terminais de modelo A8.

• Realizada a atualização de versão da Lib usdk_api_aidl, da anterior (2.3.12.20200414) para a atual (13.4.10.20211222), aos terminais de modelo A8.

Versão 2.4

Modelo de terminais compatíveis: GPOS700, GPOS700MINI e GPOS700X da Gertec, A8 e DX8000 da Ingenico, Smartphone, A910 e A920 da Pax e N910 da Newland.

Descrição da Versão:

• Realizada a correção para tratar do número do documento no banco de dados, onde anteriormente ocorriam problemas ao salvar o mesmo quando utilizada a adquirente Stone em transações e reimpressões via integração.

• Realizada a alteração na mensagem enviada junto ao código de resposta "106" das transações relacionadas às funções de requisição de Reimpressão/Reenvio, Cancelamento de Pré-Autorização, Cancelamento de Captura de Pré-Autorização e Cancelamento de Carteira Digital/QR Code, passando agora a retornar a mensagem da CliSiTef que solicita a devida formatação de data da transação a ser enviada ("DDMMAAAA" ou "DDMM", o formato pode variar de acordo com a adquirente utilizada).

• Porte para os novos modelos GPOS700MINI e GPOS700X da Gertec.

• Realizada a atualização das bibliotecas externas de Simulado e Produção para todos os modelos de terminais, contendo a adição do parâmetro para habilitar o modo de acessibilidade do PinPad Virtual nas transações de Venda, Estorno e Pré-Autorização, fluxos onde é solicitada a senha do cartão, e contendo também o tratamento na ocorrência do evento de aguardo da leitura de um cartão através do Tipo Campo 5000 da CliSiTef para que o valor das transações (exceto Estorno) seja apresentado em tela junto à mensagem de "Aproxime, insira ou passe o cartão na leitora" no buffer retornado, mediante a configuração "IdentificaMensagens=1" previamente habilitada na seção Geral do CLSIT do Parceiro via Portal SC3 Admin.

• Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.117.39.rc2) para a atual (7.0.117.45.rc1), aos terminais de modelos GPOS700 e GPOS700X onde o PinPad Virtual passa a ser exibido adequando-se à manta de acessibilidade (teclado físico de silicone), já contendo também o tratamento para que não seja mais exibida a mensagem de "Versão de desenvolvimento" a cada início de transação.

• Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.117.18.r2) para a atual (7.0.117.47.r1), aos terminais de modelo Smartphone.

• Realizada a atualização de versão da Lib bcnewland, da anterior (210) para a atual (213), aos terminais de modelo N910.

Versão 2.3

Modelo de terminais compatíveis: GPOS700 da Gertec e A8 da Ingenico.

Descrição da Versão:

• Adicionado o tratamento do dado referente ao número do documento, agora sendo possível utilizá-lo corretamente tanto para o estorno quanto para a reimpressão específica.

Versão 2.2

Modelo de terminais compatíveis: A8 da Ingenico.

Descrição da Versão:

• Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.117.11.r2) para a atual (7.0.117.38.rc2), aos terminais de modelo A8 onde corrige o comportamento de exibição do PinPad Virtual durante a leitura do cartão no fluxo transacional.

Versão 2.1

Modelo de terminais compatíveis: GPOS700 da Gertec, A8 e DX8000 da Ingenico, Smartphone, A910 e A920 da Pax e N910 da Newland.

Descrição da Versão:

• Implementada a nova função de requisição "Venda Acumulativa" para permitir a manipulação de dados relacionados aos Parâmetros do Configura e/ou aos Parâmetros do Efetua enviados nas vendas que são iniciadas através do método "initTransaction" contendo o valor da venda e o JSON de configuração (onde se faz necessária a inclusão do campo "name" referente ao Nome do Parceiro). Vide a documentação: Parâmetro de Configuração JSON, para mais detalhes sobre os dados que podem ser enviados de acordo com a regra de formatação e configuração presente no parâmetro da venda no formato JSON. Observação: Caso não haja a necessidade de manipulação dos dados da venda, os mesmos serão automaticamente acatados do Servidor e da Loja no SC3.
• Implementada a nova função de requisição "Venda Digitada via NFC" de modo à coletar os dados do cartão via NFC no início da venda e então prosseguir com o pagamento, sendo necessário apenas informar o CVV do cartão utilizado. A nova função de requisição também permite a manipulação de dados relacionados aos Parâmetros do Configura e/ou aos Parâmetros do Efetua enviados nas vendas que são iniciadas através do método "initTransaction" contendo o valor da venda e o JSON de configuração (onde se faz necessária a inclusão do campo "name" referente ao Nome do Parceiro, e do campo "coletaNfc" = "1" no formato String). Vide a documentação: Parâmetro de Configuração JSON, para mais detalhes sobre os dados que podem ser enviados de acordo com a regra de formatação e configuração presente no parâmetro da venda no formato JSON. Observação: Caso não haja a necessidade de manipulação dos dados da venda, os mesmos serão automaticamente acatados do Servidor e da Loja no SC3. Neste tipo de venda, são necessárias também as implementações dos callback's relacionados à comunicação via NFC por parte da integração.
• Adicionado ao Projeto o novo código de resposta "111" que requere a finalização da Venda Acumulativa ou da Venda Digitada via NFC ("finishTransaction(0)" para cancelar ou "finishTransaction(1)" para aprovar) ou o início de uma nova venda (através do método "initTransaction" contendo o valor da venda e o JSON de configuração) com base na mesma função de requisição utilizada, de modo à possibilitar o suporte à múltiplas vendas podendo-se utilizar um ou mais cartões.
• Adicionado ao Projeto o novo código de resposta "204" que indica sucesso no cancelamento das vendas pendentes.
• Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.117.28.r2) para a atual (7.0.117.39.rc2), aos terminais de modelo GPOS700 para corrigir o comportamento de loop ao aprovar ou cancelar uma transação pendente na integração.
• Realizada a atualização de versão da CliSiTef, aos terminais de modelo N910.
• Realizada a atualização de versão da Lib bcnewland, aos terminais de modelo N910.
• Porte para o novo modelo DX8000 da Ingenico.
• Incluídas as novas permissões do Android "android.permission.NFC" (uses-permission) e "android.hardware.nfc" como "true" (uses-feature) no AndroidManifest do Projeto para possibilitar a comunicação via NFC na integração.
• Incluídas as novas dependências da biblioteca Apache Commons no build.gradle do Projeto, que estão relacionadas às implementações utilizando-se da comunicação via NFC.
• Tratado o retorno do dado de resposta "transactionState" na integração, que agora passa estar devidamente presente no arrayList quando retornado o código de resposta "201".
• Realizada a correção caso seja tentado o início das transações relacionadas às funções de requisição de Venda, Venda Acumulativa, Venda Digitada via NFC, Captura de Pré-Autorização e Carteira Digital/QR Code contendo como valor o parâmetro vazio ou igual à zero, passando a ser retornada a mensagem de "Valor de transação inválido" no código de resposta "400".
• Ajustado para que quando retornado o código de resposta "400" indicando erro durante o fluxo transacional quando utilizadas as funções de requisição de Venda Acumulativa ou de Venda Digitada via NFC, a integração ao utilizar o método "cancelTransaction" para o encerramento da operação, possa realizar a finalização da classe ("finish()") ou o cancelamento das vendas anteriormente pendentes ("finishTransaction(0)"), de acordo com a regra de negócio proposta pela mesma.

Versão 2.0

Modelo de terminais compatíveis: GPOS700 da Gertec, A8 da Ingenico, Smartphone, A910 e A920 da Pax e N910 da Newland.

Descrição da Versão:

• Realizada a correção caso ocorra o cancelamento da operação durante o fluxo de leitura do cartão, onde agora passa a ser devidamente retornado o código de resposta "104", solicitando à integração a confirmação para que seja dado continuidade ou não ao fluxo transacional.

Versão 1.9

Modelo de terminais compatíveis: GPOS700 da Gertec, A8 da Ingenico, Smartphone, A910 e A920 da Pax e N910 da Newland.

Descrição da Versão:

• Realizada a atualização das bibliotecas externas de Simulado e Produção para todos os modelos de terminais, contendo a implementação do método automático de tradução das mensagens da CliSiTef.

• Realizada a correção de possíveis erros que ocorriam durante o fluxo transacional que não demandavam a finalização da classe, passando estes a serem retornados via código de resposta "100" como mensagem.

Versão 1.8

Modelo de terminais compatíveis: GPOS700 da Gertec, A8 da Ingenico, Smartphone, A910 e A920 da Pax e N910 da Newland.

Descrição da Versão:

• Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.116.29.r2) para a atual (7.0.117.11.r2), aos terminais de modelo A8.
• Realizada a atualização de versão da Lib bcapos, da anterior (4.16) para a atual (5.05), aos terminais de modelo A8.
• Adicionada a nova Lib dm-apos-1.6.1-a8 aos terminais de modelo A8 para atender à compatibilidade com a versão 5.05 da Lib bcapos.
• Adicionada a nova Lib usdk_api_aidl-2.3.12.20200414 aos terminais de modelo A8 para atender à compatibilidade com a versão 5.05 da Lib bcapos.
• Realizado o downgrade de versão de compilação do SDK (minSdkVersion), da anterior ("21") para a atual ("20") para atender à compatibilidade de versões.

Versão 1.7

Modelo de terminais compatíveis: GPOS700 da Gertec, A8 da Ingenico, Smartphone, A910 e A920 da Pax e N910 da Newland.

Descrição da Versão:

• Implementada a nova função de requisição "GsurfSC3Data" que possibilita o retorno com as seguintes informações em Loja no SC3 onde o terminal encontra-se ativo: Nome da Loja ("name"), E-mail ("email"), Telefone ("phone"), Código de Loja ("merchantCode"), Número Máximo de Parcelas ("maxInstallments"), CPF/CNPJ ("cnpj"), Cidade ("city"), Estado ("state"), Endereço ("address"), ID do Parceiro ("partnerId"), ID do Terminal no Sistema SC3 GSurf ("gsurfId"), Código do Terminal ("terminalCode"), Número de Série ("serialNumber"), Dias para Cancelamento de Crédito ("creditReverseLimit") e Configuração de Comprovante Eletrônico ("sendVoucherType").

Versão 1.6

Modelo de terminais compatíveis: GPOS700 da Gertec, A8 da Ingenico, Smartphone, A910 e A920 da Pax e N910 da Newland.

Descrição da Versão:

• Implementadas as novas funções de requisição e métodos para possibilitar a autenticação (verificação e instalação de certificado) do modelo Android POS através de OTP e número de série do terminal.

• Ajustado para que a biblioteca SDK não mais finalize a sessão da classe da integração quando retornado algum tipo de erro durante o fluxo transacional, onde será enviada a mensagem de "Operação cancelada" no código de resposta "100". Desta forma, quando retornado o código de resposta "400" na integração, a mesma deverá passar a utilizar o método "cancelTransaction" para o cancelamento da transação, e na sequência realizar a finalização da classe.

• Realizada a correção para que os dados da transação que estavam sendo retornados como "null" não sejam mais enviados no código de resposta "201" quando anteriormente ocorrido algum tipo de erro durante o fluxo transacional.

• Realizada a atualização de versões de compilação do SDK (minSdkVersion, targetSdkVersion, compileSdkVersion e buildToolsVersion), das anteriores ("19", "28", "28" e "28.0.3", respectivamente) para as atuais ("21", "30", "30" e "29.0.2", respectivamente), e ajustadas também as mudanças comportamentais e corrigidos os problemas de compatibilidade no Projeto, de modo a atender a biblioteca SDK ao modelo Smartphone com as versões 9, 10 ou 11 do Android.

• Incluída a nova permissão do Android "requestLegacyExternalStorage" como "true" no AndroidManifest do Projeto para tratar do problema ao salvar e enviar os arquivos de Traces quando utilizado o modelo Smartphone nas versões 9 ou 10 do Android, permissão esta que deve ser declarada na integração caso seja utilizado especificamente o referido modelo e versões.

• Implementada a validação de permissões para a ativação do novo usuário/terminal através do código de resposta "406", mantendo o mesmo tratamento conforme ocorre na ativação do usuário Master.

Versão 1.5

Modelo de terminais compatíveis: GPOS700 da Gertec, A8 da Ingenico, Smartphone, A910 e A920 da Pax e N910 da Newland.

Descrição da Versão:

• Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.116.29.r2) para a atual (7.0.117.18.r2), aos terminais de modelo Smartphone.

• Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.116.29.rc6) para a atual (7.0.117.16.rc2), aos terminais de modelos A910 e A920.

• Realizada a atualização de versão da CliSiTef (Simulado e Produção), da anterior (7.0.116.17.b6) para a atual (7.0.117.13.rc3), aos terminais de modelo N910.

• Adicionado ao Projeto os novos códigos de resposta "202" e "203" contendo respectivamente o devido retorno quando não existe transação pendente e quando existe transação pendente.

• Adicionado o retorno com os dados da transação através do código de resposta "201" quando realizada a aprovação desta transação anteriormente pendente.

• Implementada a tratativa para aprovação e cancelamento da transação pendente através respectivamente das funções "aprovarTransacao" e "cancelarTransacao" quando retornado o código de resposta "203".

• Ajustada a condição de criação do novo usuário/terminal, mantendo-a funcional somente para usuários/terminais Master. O ajuste foi aplicado no código de resposta "422" através do "UserType" quando o novo usuário/terminal tenta criar um outro novo usuário/terminal a partir deste.

• Ajustado para que o construtor contendo os dados da transação retorne "null" quando estes não são entregues pela CliSiTef.

• Adicionada a mensagem de "Envio finalizado" para ser retornada junto ao código de resposta "100" quando finalizado o envio/reenvio do comprovante via SMS e e-mail.

• Analisado que o "docNumber" salvo no banco de dados a ser utilizado para a reimpressão específica com a adquirente Cielo não é o mesmo que a CliSiTef valida para que seja possível realizar de fato a reimpressão/reenvio do comprovante, fazendo com que os dados da transação não sejam retornados via código de resposta "201" ao escolher o tipo da via a ser reimpressa ("Via Lojista", Via "Portador" e "Todos"). Tal comportamento ocorre somente em ambiente de Homologação, onde em caso de necessidade referente à validação desta funcionalidade por parte da integração, deve-se utilizar o ambiente de Produção, ou outra adquirente em ambiente de Homologação, ou ainda implementar a própria funcionalidade de forma local via banco de dados para que a reimpressão/reenvio do comprovante seja realizada independentemente do uso da CliSiTef.

Versão 1.3.3

Modelo de terminais compatíveis: GPOS700 da Gertec, A8 da Ingenico, Smartphone, A910 e A920 da Pax e N910 da Newland.

Descrição da Versão:

• Realizada a correção referente ao devido retorno via código de resposta "400" e a inclusão da função "cancelTransactionProcess" com relação ao tratamento da mensagem de erro retornada através da função "clisitefShowErrorMessage" da CliSiTef, que anteriormente à correção era tratado como "100".

• Implementada a finalização da classe caso ocorra algum erro durante o fluxo transacional que precise ser encerrado.