Integrator

App da maquininha

O app Integrator fica aberto na maquininha, busca as cobranças da fila e usa o app de pagamento da própria adquirente.

Compatibilidade

O app roda em maquininhas Android e usa o app de pagamento da adquirente instalado no aparelho. Estamos homologando os primeiros modelos, e a lista de maquininhas compatíveis será publicada aqui.

Pareamento

  1. Abra o app. Na primeira vez ele mostra a tela Parear maquininha.
  2. Toque em Escanear QR code e aponte para o QR do terminal no painel. Se preferir, digite o token itg_term_….
  3. Quando aparecer o nome do terminal com o status Online, a maquininha está pronta.

No dia a dia

  • Aguardando cobranças: tela inicial. Mostra o terminal, a conta e o status da conexão.
  • Nova cobrança: aparece sozinha com valor, método e descrição, e abre o pagamento da adquirente.
  • Resultado: aprovado, recusado ou cancelado por alguns segundos. Depois volta para a tela inicial.
  • Histórico: lista as cobranças do terminal, carregando mais conforme você rola a tela.

Configurações e PIN

O ícone de engrenagem abre as configurações, protegidas pelo PIN definido no painel. Ali dá para ver os dados do terminal e trocar o token. Sem internet, a tela abre sem pedir o PIN, já que não há como conferir. Assim você consegue corrigir um token errado mesmo offline.

Conexão e resiliência

  • Com o app aberto, a maquininha consulta a fila a cada segundo.
  • Se a internet cair depois do pagamento, o resultado fica guardado no aparelho e é enviado assim que a conexão volta.
  • Se o app for fechado no meio de um pagamento, ao reabrir ele tenta recuperar o resultado com a adquirente. Sem resposta, a cobrança vira failed com interrupted.

Trocar o token com resultados pendentes