CONNECTTEF – INTEGRAÇÃO VIA INTENT ANDROID (INTRODUÇÃO).

Resumo do que será ensinado

Neste documento você vai aprender, de forma organizada e simples, o conceito da integração via Intent Android com o ConnectTEF, quais recursos ela oferece (pagamento, estorno e impressão) e como usar essa forma de integração para que um aplicativo Android se comunique com um SmartPOS realizando operações de pagamento sem precisar implementar toda a lógica TEF dentro do app. 

Segue um Vídeo explicativo do processo

Detalhamento do uso correto

Com este guia, qualquer desenvolvedor iniciante em Android deve ser capaz de entender o papel da integração via Intent, saber quando utilizá‑la e compreender, em alto nível, como o app Android conversa com o ConnectTEF e com o SmartPOS para executar pagamentos, estornos e impressões de forma simples e padronizada. 

Segue o detalhamento de como funciona a Introdução da Integração via Intent Android

1. O que é a integração via Intent Android com o ConnectTEF

   • A integração via Intent Android é um modo de integrar seu aplicativo Android com o ConnectTEF utilizando o mecanismo padrão de comunicação entre apps do Android, chamado Intent. 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
   • Em vez de seu app implementar diretamente APIs HTTP, certificados, Webhooks, etc., ele:
     • Cria e envia um Intent para o aplicativo/serviço ConnectTEF instalado no SmartPOS.
     • O ConnectTEF interpreta esse Intent e executa a operação TEF desejada (pagamento, estorno ou impressão). 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
   • Após a operação no POS, o ConnectTEF devolve o resultado para o seu app por meio de dados retornados no Intent de resposta (por exemplo, via onActivityResult ou mecanismo equivalente).

   Ponto importante

   • Essa abordagem simplifica a vida do desenvolvedor Android: boa parte da complexidade de pagamentos é delegada ao ConnectTEF, enquanto o app apenas dispara Intents e trata os resultados. 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .

2. Recursos disponíveis na integração via Intent

   A documentação oficial destaca três recursos principais disponíveis por Intent: 

   Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade

   • Pagamento com cartão:

     • Suporte a:
     • Débito.
     • Crédito à vista e parcelado.
     • PIX / carteira digital.
     • Voucher / benefícios (PAT, refeição, alimentação). 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     • O app envia um Intent com:
     • Valor.
     • Tipo de transação.
     • Eventuais dados de referência (identificador da venda).

   • Estorno de transações:

     • Permite desfazer uma transação de pagamento já autorizada, respeitando regras de prazo e adquirente. 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     • O app dispara um Intent informando os dados da transação original (como NSU ou identificador).

   • Impressão de comprovantes personalizados:

     • Possibilita enviar textos/linhas a serem impressas diretamente no comprovante do POS. 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     • Útil para:
     • Comprovante adicional da loja.
     • Mensagens personalizadas ao cliente.
     • Informações fiscais ou promocionais.

   Ponto importante

   • Esses três recursos (Pagamentos, Estornos e Impressões) são a base da integração por Intent e aparecem detalhados em páginas específicas da documentação: Introdução, Pagamento, Estorno. 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .

3. Quando faz sentido usar a integração via Intent Android

   • A integração via Intent é especialmente adequada quando: 

     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     • Seu produto é um aplicativo Android rodando em SmartPOS.
     • Você deseja realizar pagamentos sem integrar diretamente via API HTTP/mTLS/Webhook.
     • Procura uma solução mais simples e rápida para integrar com o ConnectTEF.

   • Vantagens práticas:

     • Menos código de infraestrutura de rede, segurança e TEF dentro do seu app.
     • Uso do fluxo nativo de Android (Intents) que muitos desenvolvedores já conhecem.
     • Facilidade de manutenção: o app permanece mais focado em regras de negócio e menos em detalhes de integração de pagamento.

   Pontos de atenção

   • Mesmo usando Intents, é responsabilidade do app:
     • Enviar corretamente os parâmetros (valor, tipo de transação, identificadores).
     • Tratar a resposta (sucesso, falha ou cancelamento).
     • Atualizar seus registros internos (venda, estorno, impressão) conforme resultado.

4. Visão geral do fluxo de integração via Intent

   De forma simplificada, o fluxo padrão é: 

   Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade

   1. Seu app Android prepara os dados da operação

      • Exemplo de dados:
      • Valor total da venda (ex.: 100,00).
      • Tipo de pagamento (crédito, débito, PIX, voucher).
      • Identificador interno da venda ou comanda (ex.: idVenda = "12345").

   2. Seu app cria um Intent destinado ao aplicativo/serviço ConnectTEF no SmartPOS

      • No Intent, o app embute os dados da operação (extras).
      • Dispara o Intent usando o mecanismo padrão (por exemplo, startActivityForResult(...) ou equivalente).

   3. O ConnectTEF recebe o Intent e executa a operação TEF

      • Exibe telas de pagamento no POS.
      • Permite que o cliente insira o cartão, escolha parcelas, confirme o pagamento etc.

   4. Após concluir a operação, o ConnectTEF devolve o resultado ao app

      • Preenche um Intent de resposta com:
      • Status da transação (aprovada, cancelada, erro).
      • Código de autorização.
      • NSU (número da transação).
      • Valor final.
      • Mensagens de operador.
      • Seu app lê esses dados e:
      • Conclui a venda.
      • Registra o estorno.
      • Armazena comprovantes ou referências.

   Ponto importante

   • Cada recurso (Pagamento, Estorno e Impressão) tem estrutura de Intent específica, detalhada nas páginas seguintes da documentação (Pagamento, Estorno). 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .

5. Relação da integração via Intent com outras formas de integração ConnectTEF

   • A documentação geral do ConnectTEF apresenta vários modos de integração: 

     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     • WEB/SaaS (via API HTTP + Webhooks+mTLS).
     • Desktop / API Local POS (com criação e consulta de operações).
     • API em nuvem (SmartPOS via API).
     • Android via Intent (este documento).

   • A integração via Intent:

     • Não substitui as demais, mas é um **caminho específico para