Integrator

Guias

Terminais e pareamento

Um terminal representa uma maquininha. Você cria no painel, pareia no aparelho e usa o id dele na API.

Criar um terminal

  1. No painel, abra Terminais → Novo terminal.
  2. Escolha um nome e um PIN de 4 a 8 dígitos. O PIN protege a tela de configurações do app.
  3. Confirme. O custo de criação (se houver) é descontado do seu saldo, que precisa cobrir esse valor.
  4. O painel mostra o token (itg_term_…) e o QR code uma única vez. Escaneie na maquininha ou guarde o token num lugar seguro.

Vínculo com o aparelho

Na primeira vez que a maquininha usa o token, o terminal fica vinculado àquele aparelho. Se o mesmo token for usado em outro aparelho, as requisições são recusadas. Para trocar de maquininha:

  • Desvincular aparelho: o próximo aparelho que usar o token vira o novo vínculo. O token continua o mesmo.
  • Gerar novo token: invalida o token antigo na hora e remove o vínculo. Use quando o token vazou ou a maquininha foi perdida.
  • Revogar: desativa o terminal de vez. Cobranças antigas continuam no histórico.
O id do terminal nunca muda, nem quando você gera um novo token. Seu sistema pode guardá-lo com segurança.

Listar terminais pela API

GET/v1/terminals
JSON
{
  "data": [
    {
      "id": "6f1c2b8e-2f4a-4c55-9a59-6a1d5b1f0c3e",
      "object": "terminal",
      "label": "Caixa 1",
      "acquirer": null,
      "online": true,
      "last_seen_at": "2026-10-13T18:21:03.004Z",
      "revoked": false,
      "created_at": "2026-10-01T12:00:00.000Z"
    }
  ]
}

online é true quando a maquininha se comunicou nos últimos 15 segundos. Com o app aberto, ela consulta a fila a cada segundo. Uma cobrança enviada para um terminal offline fica na fila até expirar.

Boas práticas

  • Mostre ao operador do seu sistema se o terminal escolhido está online antes de cobrar.
  • Mantenha o app Integrator aberto em primeiro plano na maquininha. A tela fica ligada sozinha.
  • Veja o passo a passo do aparelho em App da maquininha.
Anterior← AutenticaçãoPróximoCobranças →