m-SiTef: Programa Exemplo - Android (Kotlin)

[matheusferreira]

   Entendendo o projeto Android - Kotlin

Criamos um programa exemplo que se integra com o m-SiTef que você pode utilizar como base para seu sistema Android (Kotlin ou Java).

 

m-SiTef

O m-SiTef é um aplicativo desenvolvido pela Fiserv para a plataforma Android e funciona através da comunicação por Intents, ou seja, os dados são passados de uma aplicação (Programa exemplo) para outra (m-SiTef) pela própria Intent, sem a necessidade de um SDK ou outra solução para essa comunicação.

Para entender melhor como funciona a comunicação entre aplicativos android por intents:
https://medium.com/@ashfaque-khokhar/intent-in-android-00f7be3197c0.


Exemplo de dados sendo transmitidos de Intent para outra intent.

Intent  intent  =  new  Intent (getApplicationContext(), SecondActivity.class); 
intent.putExtra( "NAME" , "Ashu" ); 
intent.putExtra( "ID" , 21 ); 
startActivity(intent);

Para se integrar ao m-SiTef devemos passar os dados da forma como estão descritos no guia de integração, que você pode encontrar completo aqui:

• https://dev.softwareexpress.com.br/docs/m-sitef/m-SiTef/

 

 Projeto

O nosso projeto de integração está no nosso GitHub:
https://github.com/Projeto-ACBr-Oficial/acbr-sitef-android

Antes de clonar o projeto e rodar, não se esqueça de iniciar o SitDemo e estar com o APK do m-SiTef instalado no terminal Android que fará os testes.

Saiba mais sobre estes processos: 

 

Para conseguir rodar corretamente o nosso programa exemplo você precisa configurar alguns campos passados ao aplicativo do m-SiTef:

• Endereço IP do SitDemo
• CNPJ ou CPF
• CNPJ da Automação

Utilize a tela de configuração da aplicação:

 

  Entendendo o projeto

O core desta integração está na classe fiserv/msitef/src/main/java/com/mjtech/fiserv/msitef/payment/MSitefPaymentProcessor.kt

Nesta classe é feito o mapeamento de todos os campos necessários para fazer os pagamentos na função Débito, Crédito (Á vista e parcelado), Pix e Voucher.

Outra classe importante é a fiserv/msitef/src/main/java/com/mjtech/fiserv/msitef/payment/MSitefPaymentActivity.kt.

Esta classe é responsável por abrir o APP do m-SiTef e receber e mapear o resultado retornado pelo m-SiTef acionando o callback conforme o retorno recebido.
 

Menu administrativo

O menu administrativo está na tela de configurações e é uma importante funcionalidade que deve ter na sua aplicação para acessar as principais funções como cancelamento, reimpressão, teste de comunicação, etc. 

O core do mapeamento dos parâmetros referente ao menu administrativo está nesta classe:
fiserv/msitef/src/main/java/com/mjtech/fiserv/msitef/settings/MSitefAdminHandler.kt

Já a classe 
fiserv/msitef/src/main/java/com/mjtech/fiserv/msitef/settings/MSitefAdminActivity.kt
é responsável por chamar o aplicativo do m-SiTef passando os parâmetros necessários e responsável por capturar o retorno.

 

   Roteiro de pré-homologação

Uma etapa importante do processo de desenvolvimento e homologação é o roteiro de pré-homologação.

Algumas etapas do roteiro de testes exigem valores exatos como R$25.000 ou R$15,00 e a troca de alguns campos de configurações, foi pensando nestes testes que fizemos este programa exemplo, onde você consegue informar o valor exato na tela de pagamento e modificar os campos de configuração em tempo de execução.

Fluxo de pagamento:

        

 

Esta aplicação já passou pelo roteiro de teste de pré-homologação e você pode utilizar como base para o seu projeto.

Em nosso curso -> T.E.F e Meios de Pagamentos, já estão disponíveis as aulas sobre o Pré-Roteiro de Homologação - MSiTef. 

_________________________________________________________________

 Referências

- Toda a integração foi guiada pela documentação oficial disponibilizada pela própria Fiserv no link: https://dev.softwareexpress.com.br/docs/m-sitef/m-SiTef/

 

Estamos disponíveis para qualquer dúvida ou sugestão.