Como integrar a Point Smart ao seu sistema de gestão (PDV)

Para integrar a Point Smart ao PDV, você precisa: criar credenciais na conta Mercado Pago, configurar lojas e caixas no painel e conectar o terminal ao seu sistema via API Point. Com isso, cada cobrança criada no PDV é enviada automaticamente para a maquininha, o comprador paga e o status retorna ao sistema em tempo real. Nenhum valor precisa ser digitado duas vezes.

Neste artigo, vamos ver o passo a passo completo da integração, os pré-requisitos técnicos, como lidar com múltiplos caixas e o que o banco digital Mercado Pago oferece para tornar esse processo ainda mais robusto para o seu negócio.

Passo a passo: integre a Point Smart ao PDV em 4 passos

Antes de começar, tenha em mãos uma conta Mercado Pago ativa, uma Point Smart 2 carregada e vinculada à sua conta, bem como acesso ao painel de desenvolvedor para gerar suas credenciais.

Importante: fazer a integração é algo inerentemente técnico e requer conhecimento em desenvolvimento de software. Se você não tem esse perfil, recomendamos acionar um desenvolvedor especializado. O Mercado Pago conta com um programa de parcerias que conecta vendedores a agências e desenvolvedores certificados para esse tipo de integração.

1. Configure lojas e caixas no Mercado Pago

Acesse sua conta Mercado Pago e navegue até Seu negócio > Lojas e caixas > Começar. Caso não encontre esse caminho, tente Negócio > Configurações > Lojas e Caixas. Cadastre o nome da loja sem espaços ou caracteres especiais (evite @, #, $, %, &) e informe o endereço e horário de funcionamento.

Em seguida, crie um caixa para cada terminal que será integrado, também sem espaços no nome.

2. Gere as credenciais de acesso

Para se comunicar com a API do Mercado Pago, você precisa de um Access Token vinculado a uma aplicação. Siga o passo a passo abaixo:

• Acesse mercadopago.com.br/developers e clique em Entrar, no canto superior direito. Use os dados da sua conta Mercado Pago.
• Clique em Suas integrações, também no canto superior direito.
• Crie uma nova aplicação ou selecione uma já existente.
• No menu lateral esquerdo, acesse Produção > Credenciais de produção.
• Preencha o campo Indústria com o ramo do seu negócio para ativar as credenciais.
• Copie o Access Token exibido na tela. Esse é o código que autoriza o seu PDV a se comunicar com a API.

Guarde esse token com segurança no servidor da aplicação. Nunca o exponha no front-end ou em repositórios públicos.

3. Conecte o terminal via API Point

Com as credenciais em mãos, o desenvolvedor vai usar a API de Integrações Point do Mercado Pago para criar ordens de pagamento diretamente do PDV. Cada ordem é enviada para o terminal e carregada automaticamente na tela da maquininha. O processo tem duas chamadas principais:

a) Identifique o terminal

Primeiro, liste os terminais vinculados à conta com uma requisição GET ao endpoint https://api.mercadopago.com/terminals/v1/list, passando o Access Token no cabeçalho de autorização. A resposta retorna o id de cada terminal. Confirme qual é o correto pelo número de série na etiqueta atrás da maquininha e guarde esse valor para o próximo passo.

b) Crie a ordem de pagamento

Com o id do terminal em mãos, envie uma requisição POST para https://api.mercadopago.com/v1/orders. No corpo da requisição, informe o valor da cobrança, o terminal_id e, opcionalmente, as configurações de parcelamento e impressão de comprovante. Se a ordem for criada com sucesso, a API retorna status created e a maquininha recebe a cobrança automaticamente na tela. Caso não apareça, basta pressionar o botão Atualizar no terminal.

Salve o id da ordem e o id do pagamento retornados na resposta. Eles são necessários para consultar o status da transação e processar as notificações.

• Atenção: inclua sempre um X-Idempotency-Key único por requisição (use um UUID v4). Ele evita que a mesma cobrança seja registrada duas vezes em caso de falha de rede.

4. Configure os webhooks de notificação

Os webhooks são a forma como o Mercado Pago avisa o seu sistema em tempo real sobre o resultado de cada transação, isto é, se o pagamento foi aprovado, recusado ou cancelado. Para configurar, acesse Suas integrações no painel de desenvolvedor, selecione a aplicação criada para a integração Point e informe a URL do servidor do PDV que vai receber as notificações. Essa URL precisa ser pública e acessível pela internet.

Sempre que uma transação for concluída, o Mercado Pago vai enviar automaticamente uma requisição POST para esse endereço com o status atualizado da ordem. O sistema do PDV deve processar essa notificação e, se necessário, confirmar o recebimento respondendo com HTTP 200. Caso contrário, o Mercado Pago vai tentar reenviar.

Antes de ativar no caixa real, teste o fluxo completo em ambiente de sandbox usando credenciais de teste. Só substitua pelo Access Token de produção quando tudo estiver funcionando como esperado.

Como gerenciar múltiplos caixas integrados

Negócios com mais de um terminal precisam de uma configuração individualizada para cada ponto de venda. Cada maquininha deve ser vinculada a um caixa distinto criado no painel do Mercado Pago, tendo um terminal por caixa, sem compartilhamento.

Criando caixas adicionais

Para adicionar uma segunda maquininha ou mais, repita o processo de criação de caixas na seção Lojas e Caixas. Dê nomes únicos e sem caracteres especiais a cada um. Ao criar a intenção de pagamento via API, informe o identificador do caixa correto para que a ordem chegue ao terminal certo.

Conciliação centralizada

Uma das vantagens da integração é que todas as transações ficam centralizadas no painel do banco digital Mercado Pago, independentemente de quantos caixas estejam ativos. Isso reduz o trabalho de conferência manual ao final do dia e diminui a chance de divergências entre o sistema de gestão e os registros financeiros.

Conheça ferramentas de conciliação financeira automática e entenda como elas podem facilitar a gestão do seu negócio.

O que o Mercado Pago oferece para sua operação integrada

Nossa infraestrutura foi desenvolvida para atender desde pequenos negócios até operações com múltiplos pontos de venda. Ao integrar a Point Smart 2 ao seu PDV, você conta com:

• API unificada de pagamentos: uma única integração para processar crédito, débito, alimentação e refeição, sem necessidade de múltiplas soluções de TEF.
• Conciliação automática: as vendas são registradas e conciliadas diretamente no banco digital, acessíveis pelo painel ou por exportação de relatórios.
• Notificações em tempo real: webhooks informam o status de cada transação ao seu sistema sem necessidade de consultas manuais.
• Ambiente de sandbox: teste toda a integração antes de ir à produção, sem movimentar dinheiro real.
• Suporte a múltiplos caixas: escale a operação adicionando terminais sem alterar a estrutura principal da integração.
• Conta Negócio: centraliza pagamentos de todos os PDVs, permite fazer transferências e organiza sua gestão em um só lugar, para uma estrutura financeira mais completa.

Além da maquininha, você pode explorar outras ferramentas para vender do Mercado Pago para complementar sua operação presencial e online.

Comece a integrar sua Point Smart hoje

A integração da Point Smart ao PDV transforma a operação de pagamentos: menos digitação, menos erros e conciliação que acontece sem intervenção manual. O caminho passa por configurar lojas e caixas, gerar credenciais e implementar os endpoints de API, etapas que qualquer equipe de desenvolvimento consegue executar com a documentação disponível.

Se você ainda não tem uma maquininha ou quer conhecer todas as opções disponíveis, confira todos os modelos disponíveis de maquininhas Point e escolha a opção mais adequada para o seu volume de vendas.