Jefácil Jefácil
Documentação / PDV e caixa / Maquininha de cartão

Conectando a maquininha, o PDV manda o valor para ela. O operador não digita o total na máquina, então some o erro de digitar R$ 190 no lugar de R$ 910 — e a venda só fecha quando a cobrança é aprovada de verdade.

Configuração em Configurações › Maquininha. Hoje o provedor suportado é o Mercado Pago Point.

Ligar

  1. Conecte a conta do provedor na loja — no Mercado Pago, pelo botão Conectar com Mercado Pago (entra na conta e autoriza). Se a empresa já conectou a conta em outra tela, basta clicar em Usar.
  2. Sincronize os terminais — as máquinas aparecem sozinhas.
  3. Dê nome a cada uma (“Caixa 1”, “Balcão do fundo”). É esse nome que o operador vê.
  4. Marque qual fica em modo PDV.

Quem mexe aqui precisa da permissão de gerenciar maquininha; quem só opera o caixa consegue enxergar as máquinas para cobrar.

A credencial fica cifrada e nunca volta numa tela — o sistema mostra que existe uma, não qual é.

Sem o botão: colar as chaves

O caminho normal é o botão Conectar com Mercado Pago. Se ele não aparecer, ou se você preferir, abra Prefiro colar as chaves — a tela pede o access token e, opcionalmente, o segredo do webhook. Os dois ficam no site do Mercado Pago, não na maquininha. Faça pelo computador, logado na mesma conta da maquininha.

Pegar o access token

  1. Entre em Mercado Pago Developers › Suas integrações e clique em Criar aplicação.
  2. Dê um nome (ex.: “Jefácil”), escolha Pagamentos presenciais e o produto Mercado Pago Point, aceite os termos e confirme.
  3. No menu da esquerda, abra Produção › Credenciais de produção. Na primeira vez ele pede o ramo e o site do negócio — preencha e clique em Ativar credenciais de produção.
  4. Copie o Access Token (começa com APP_USR-) e cole no Jefácil.

Use o de produção. O de teste começa igual, mas não cobra na maquininha de verdade.

Pegar o segredo do webhook (opcional)

Sem ele a confirmação do pagamento chega igual, só um pouco mais devagar. Para confirmar na hora:

  1. Na mesma aplicação, abra Webhooks › Configurar notificações, aba Modo de produção.
  2. Cole a URL que a tela do Jefácil mostra — tem um botão Copiar ao lado.
  3. Marque o evento Order (Mercado Pago) e clique em Salvar configuração.
  4. Copie a chave secreta que aparece e cole no Jefácil.

Nenhuma maquininha apareceu

A máquina precisa estar num caixa no Mercado Pago: confira em Seu negócio › Lojas e caixas — um caixa por maquininha. Depois clique em Buscar maquininhas de novo.

Cobrando

No diálogo de pagamento, escolha a maquininha. O valor vai para a máquina e a tela acompanha:

O que a tela diz O que está acontecendo
Enviando A cobrança foi criada.
Passe o cartão Está na máquina, esperando o cliente.
Aprovada Deu certo. A venda segue.
Recusada / Cancelada / Expirou Não passou. Tente de novo ou escolha outra forma.

Uma cobrança viva por máquina. Se você tentar cobrar numa máquina que já tem cobrança em andamento, o sistema recusa. É o que impede duas vendas disputarem o mesmo terminal e o cliente errado pagar.

Cobrança aprovada que não virou venda

Acontece: a cobrança é aprovada e a venda não fecha — a internet caiu, a aba fechou, alguém saiu da tela.

O dinheiro entrou de verdade e o Jefácil não esconde isso. No PDV aparece um aviso: “1 cobrança foi aprovada e não virou venda”, com a lista. Dali você fecha a venda que faltou.

É de propósito que ele fique visível e incômodo: cobrança aprovada sem venda é dinheiro na conta sem registro no caixa, e no fechamento do dia vira sobra que ninguém explica.

Se a maquininha não responder

  • O status pode chegar atrasado. O provedor reenvia aviso e nem sempre na ordem — o sistema ignora aviso velho, então uma cobrança aprovada não volta para “passe o cartão”.
  • Cobrança sem resposta fica como desconhecida e é reconciliada quando o provedor responde. Ela ocupa a máquina até resolver.
  • Estornar só é possível depois de aprovada.

O que ela não faz

  • Não substitui a forma de pagamento no fechamento: a venda continua registrada como cartão, e o valor entra no relatório por forma.
  • Não cobra Pix — o Pix do PDV tem caminho próprio.
Faltou algo ou ficou com dúvida neste guia? Fala com a gente no WhatsApp →