Primeiros passos
Conceitos
Modelo de negócio, tipos de card e escopos de integração do Smart TEF.
O Smart TEF transforma uma Smart POS em um terminal de pagamento integrado ao ERP, PDV ou sistema de retaguarda, sem cabos ou equipamentos adicionais.
O sistema externo envia ordens pela API. O POS exibe cada ordem como um card operacional, processa a ação e devolve o resultado por consulta ativa ou webhook.
Escopos de integração
| Escopo | Quando usar |
|---|---|
| ERP Loja | Operações do dia a dia da loja: pagamentos, impressões, formulários, usuários, terminais, webhook e configurações da loja. |
| Integrador | Administração de lojas vinculadas: ativação, bloqueio, desbloqueio, geração de token e revogação de token. |
Use sempre o token compatível com o escopo da operação. Token de loja não substitui token de integrador, e token de integrador não substitui o token operacional da loja.
Tipos de card
| Card | Objetivo |
|---|---|
| Card de pagamento | Solicitar pagamento no POS, acompanhar status, cancelar pendência ou solicitar estorno. |
| Card de impressão | Enviar conteúdo para impressão no POS e acompanhar o processamento. |
| Formulário | Coletar dados estruturados no POS e consultar o preenchimento. |
Casos de uso
| Segmento | Aplicação comum |
|---|---|
| Varejo e PDV | Enviar pagamento vinculado a venda e emissão fiscal. |
| Delivery e restaurantes | Direcionar pagamento para operador ou terminal específico. |
| Força de vendas | Registrar cobranças externas com acompanhamento centralizado. |
| Logística | Coletar dados ou confirmar operações no POS. |
| Posto de combustível | Integrar pagamento ao fluxo operacional da bomba ou caixa. |
Ciclo de uma ordem
- O sistema externo cria a ordem pela API.
- O Smart TEF registra o card e controla o status.
- O POS exibe a ordem para o operador.
- O operador executa pagamento, impressão ou preenchimento.
- O sistema externo recebe o resultado por polling ou webhook.