Configurando a maquininha Mercado Pago no Gransoftweb - Parte 3
Parte 3: Aprenda a configurar a integração do Mercado Pago Point no Gransoftweb, conectar a conta, cadastrar maquininhas, definir modalidades de recebimento e testar os pagamentos integrados.
Série Pagamento integrado · GransoftWeb · Parte 3 de 4
Como configurar a maquininha de cartão no GransoftWeb: tutorial completo
Neste tutorial você deixa o GransoftWeb pronto para cobrar na maquininha Mercado Pago Point: chave da filial, conta da operadora, maquininhas e a forma de pagamento “maquininha” usada na baixa das parcelas.
Se voce utiliza o Gransoft windows: Clique Aqui para ler o tutorial referente o sistema windows.
Depois de configurado, o valor sai do GransoftWeb direto para a maquininha, o pagamento aprovado baixa as parcelas sozinho e a nota fiscal recebe os dados do cartão ou do Pix automaticamente.
Antes de começar
A conta Mercado Pago, a loja, o caixa e a maquininha são preparados antes, no Mercado Pago: veja a Parte 2. Para entender por que a integração existe, veja a Parte 1.
O que você vai aprender
Onde fica a tela Pagamento Eletrônico (Maquininha / Pix) e o que cada botão faz.
Como cadastrar e conectar a conta Mercado Pago Point da filial.
Como cadastrar as maquininhas e escolher a sua maquininha padrão.
Como criar a modalidade de recebimento integrada.
Como testar e corrigir os erros mais comuns.
1. Pré-requisitos
Usuário do GransoftWeb com acesso ao Financeiro e aos Parâmetros do cadastro.
Chave da filial da Central Geper, fornecida pela Gransoft para o CNPJ da filial (necessária para conectar a conta Mercado Pago e receber os avisos de pagamento).
Conta Mercado Pago da empresa e maquininha Point compatível, vinculada a uma loja e a um caixa no Mercado Pago.
Navegador com pop-ups liberados para o endereço do GransoftWeb (a conexão com o Mercado Pago abre uma nova aba).
2. Visão geral
Onde
O que se configura
Financeiro › Pagamento Eletrônico (Maquininha / Pix), aba Configuração da filial
Chave da Central Geper, conta da operadora e maquininhas. É por filial.
Cadastro › Parametros › Modalidades Recebimento
A forma de pagamento que aparece na baixa (ex.: “Mercado Pago Point”), ligada à operadora.
A mesma tela tem as abas Cobranças (acompanhar, consultar, cancelar e estornar) e ECONF pendentes, explicadas na Parte 4.
3. Passo 1 — Abrir a tela de Pagamento Eletrônico
Figura 1. (1) Financeiro, (2) Parcelas a Receber — usado na cobrança — e (3) Pagamento Eletrônico (Maquininha / Pix).
No menu superior, clique em Financeiro › Pagamento Eletrônico (Maquininha / Pix).
Na aba Configuração da filial, escolha a filial no campo Filial. A tela recarrega com os dados daquela filial.
Figura 2. Configuração da filial já preenchida (dados fictícios de demonstração).
Nº
Campo / botão
Para que serve
1
Filial
Filial que está sendo configurada.
2
Chave da filial + Gravar e testar
Chave da Central Geper. Mostrar exibe ou oculta a chave.
3
Nova conta
Cadastra a conta da operadora (grade: Operadora, Descrição, Ambiente, Ativa, Conexão OAuth). É o único botão da barra da grade.
4
Ações (+)
Fica na linha de cada conta e abre o menu com as ações daquela conta (Figura 2a). Não é preciso selecionar a linha antes.
Figura 2a. Menu Ações (+) da conta Mercado Pago Point.
Nº
Item do menu
Para que serve
1
Editar
Altera a conta da operadora (Passo 3).
2
Maquininhas
Abre a janela com as maquininhas da conta (Passo 5).
3
Testar conexão
Confere o acesso à conta Mercado Pago.
4
Conectar com Mercado Pago
Autoriza o GransoftWeb na sua conta Mercado Pago (Passo 4).
5
Apontar webhook
Para Mercado Pago, só informa que os avisos são configurados pela Gransoft no aplicativo dela; nada a fazer.
O menu mostra só o que vale para a operadora da linha: Conectar com Mercado Pago aparece apenas em conta Mercado Pago, e Maquininhas não aparece em operadoras sem cadastro de maquininha (ex.: Pix pela API do banco).
Figura 2b. Ações (+) › Apontar webhook com Mercado Pago: apenas informa o endereço configurado pela Gransoft.
4. Passo 2 — Gravar a chave da filial
Cole a chave recebida da Gransoft no campo Chave da filial.
Clique em Gravar e testar. O GransoftWeb confere a chave na Central Geper e se ela pertence ao CNPJ da filial.
Sem chave não há conexão
Sem a chave gravada, Ações (+) › Conectar com Mercado Pago responde: “Informe e grave antes a chave da central Geper desta filial.”
Figura 3. Mensagem ao tentar conectar sem a chave da filial.
5. Passo 3 — Cadastrar a conta Mercado Pago Point
Clique em Nova conta. Abre a janela Nova conta de operadora.
Preencha os campos (tabela abaixo) e clique em Gravar.
Figura 4. Nova conta de operadora (dados fictícios; o token foi ocultado na imagem).
Nº
Campo
Como preencher
1
Operadora e Ativa
Mercado Pago Point, com Ativa marcada.
2
Descrição
Nome fácil (ex.: Mercado Pago - Loja Centro).
3
Ambiente
Produção para cobranças reais; “Teste / homologação” só com orientação do suporte.
4
Access Token
Preenchido pela conexão do Passo 4. Alternativa: colar o Access Token de produção da sua conta (Parte 2). Nunca compartilhe esse dado.
5
Refresh token (OAuth)
Preenchido pela conexão; permite a renovação automática. Não digite.
6
CNPJ credenc. / banco
CNPJ da instituição de pagamento informado na nota. Mercado Pago: 10573521000191 (se ficar vazio, o sistema usa esse valor).
7
Parâmetros
Opcionais, um por linha: ImprimirComprovante=0 (não imprime comprovante na maquininha; o padrão imprime a via do lojista), IntegratorId= e PlatformId= só se fornecidos pela Gransoft/Mercado Pago. A conexão grava OAuth, OAuthExpira e OAuthUserId.
8
Gravar
Salva a conta (os tokens são gravados cifrados no banco).
Para alterar uma conta já cadastrada, use Ações (+) › Editar na linha dela.
Chave Pix, Certificado (.pfx) e senha não são usados pelo Mercado Pago. Cada filial pode ter uma conta ativa por operadora (“Já existe uma conta ativa desta operadora nesta filial.”).
6. Passo 4 — Conectar a conta com o Mercado Pago
Na linha da conta, clique em Ações (+) › Conectar com Mercado Pago. O navegador abre uma nova aba do Mercado Pago.
Na nova aba, entre na conta Mercado Pago da loja e autorize o Gransoft.
Quando aparecer Conta conectada, volte à aba do GransoftWeb e clique em Sim na pergunta “Na nova aba, entre na conta Mercado Pago da loja e autorize o Gransoft…”.
O sistema grava sozinho e confirma: “Conta Mercado Pago conectada (usuário …).” A coluna Conexão OAuth da grade passa a mostrar a conexão.
Figura 5. Ilustração do fluxo de conexão. No GransoftWeb, depois de “Sim”, a conta já fica gravada (não é preciso clicar em Gravar).
A nova aba não abriu?
Libere pop-ups para o endereço do GransoftWeb no navegador e clique de novo em Ações (+) › Conectar com Mercado Pago. Se clicar em Sim antes de autorizar, o sistema pergunta de novo.
A conexão vale por um período (gravado em OAuthExpira) e é renovada automaticamente quando faltam menos de 15 dias. Token colado manualmente não é renovado.
7. Passo 5 — Cadastrar as maquininhas
Na linha da conta, clique em Ações (+) › Maquininhas. Abre a janela Maquininhas da conta (Figura 6).
Clique em Buscar na operadora: o GransoftWeb traz as maquininhas da conta Mercado Pago e cadastra as novas.
Se preferir, use Adicionar e informe a identificação do terminal no Mercado Pago (formato MODELO__NUMERODESERIE, ex.: NEWLAND_N950__N950NCB000000001). Uma identificação já cadastrada não é duplicada.
Selecione a maquininha e clique em Ativar modo PDV. Reinicie a maquininha e confira em Mais opções › Configurações › Modo de vinculação.
Selecione a maquininha que você usa e clique em Usar como minha padrão: a coluna Padrão do usuário mostra “Minha padrão”, e ela já vem escolhida nas suas cobranças.
Clique em Fechar.
Figura 6. Janela Maquininhas: (1) Buscar na operadora, (2) Adicionar, (3) Usar como minha padrão, (4) Remover e (5) Ativar modo PDV. Dados fictícios.Figura 6a. Adicionar maquininha pela identificação (exemplo fictício).
Padrão por usuário
No GransoftWeb a maquininha padrão é de cada usuário. Cada operador de caixa marca a sua com Usar como minha padrão.
8. Passo 6 — Criar a modalidade de recebimento integrada
Figura 7. Cadastro › Parametros.
Abra Cadastro › Parametros e, no campo de seleção, escolha Modalidades Recebimento.
Clique em Cadastrar Novo (ou na lupa de uma modalidade existente).
Preencha a aba Dados e, na aba Taxas, a taxa, os dias para pagamento e o Nr. Máximo Prest. (máximo de parcelas oferecido na cobrança).
Clique em Salvar.
Figura 8. (1) Modalidades de Recebimento, (2) Cadastrar Novo. Em verde, a modalidade de demonstração. Um registro de teste interno foi ocultado.Figura 9. Modalidade “Mercado Pago Point” com a forma escolhida na cobrança (exemplo).Figura 9a. Aba Taxas: taxa (%), dias para pagamento e Nr. Máximo Prest. (exemplo).
Nº
Campo
Como preencher
1
Meio de Recebimento
Cartão Crédito (ou Cartão Débito / Depósito Bancário se a modalidade for só de débito ou Pix).
2
Descrição
Nome que aparece na baixa (ex.: Mercado Pago Point).
3
Receber na Conta
Conta de capital do recebimento.
4
Regra Para Empresa
“Todas as Empresas” ou só a filial que tem a maquininha.
5
Integração (maquininha / Pix)
Mercado Pago Point. “(nenhuma - modalidade comum)” desfaz a integração.
6
Forma integrada
Escolher na cobrança (cartão ou Pix): uma só modalidade, e o operador escolhe crédito, débito ou Pix na janela de cobrança. Também é possível fixar Crédito, Débito ou Pix, ou deixar “(pela modalidade)”.
7
Salvar
Grava a modalidade.
Uma modalidade ou três?
Com Escolher na cobrança, se você também tiver modalidades da mesma operadora com forma Crédito, Débito ou Pix, elas saem da tela de recebimento e passam a definir as taxas, os prazos e a conta de capital de cada forma — a baixa usa a modalidade da forma que o cliente pagou.
9. Passo 7 — Testar
Na linha da conta, clique em Ações (+) › Testar conexão. Esperado: “Conexão com o Mercado Pago OK. Terminais encontrados: N.”
Faça uma cobrança real de valor baixo num pedido de teste e estorne em seguida (Parte 4).
Figura 10. Teste com token fictício: “Access Token do Mercado Pago inválido.” — reconecte a conta.
10. Exemplo prático
A filial “Loja Centro” de uma marmoraria tem uma maquininha Point Smart no caixa:
Em Financeiro › Pagamento Eletrônico, escolhe a filial, cola a chave e clica em Gravar e testar.
Clica em Nova conta, escolhe Mercado Pago Point, descrição “Mercado Pago - Loja Centro”, Produção, e grava.
Em Ações (+) › Conectar com Mercado Pago, autoriza na nova aba e responde Sim.
Em Ações (+) › Maquininhas, clica em Buscar na operadora, ativa o modo PDV, reinicia a maquininha e a marca como minha padrão.
Cria a modalidade “Mercado Pago Point” com Forma integrada “Escolher na cobrança” e 12 parcelas no máximo.
Testa a conexão e faz uma cobrança de R$ 1,00 com estorno.
11. Mensagens e erros comuns
Mensagem
O que fazer
Tabelas da integração não encontradas (aplique o DDL do pagamento eletrônico)
A base ainda não recebeu a atualização da integração. Acione o suporte.
Informe e grave antes a chave da central Geper desta filial.
Grave a chave (Passo 2).
Esta ação vale só para conta Mercado Pago (crie com 'Nova conta' se ainda não existir).
Use o menu Ações (+) da linha da conta Mercado Pago.
Conexão não concluída: …
Autorização não concluída no Mercado Pago. Repita.
Já existe uma conta ativa desta operadora nesta filial.
Edite a conta existente.
Access Token do Mercado Pago inválido.
Reconecte a conta ou cole o Access Token de produção.
Mercado Pago HTTP 401: invalid access token (ao ativar o modo PDV)
Mesmo caso: token inválido. Reconecte a conta.
O terminal precisa estar vinculado a uma loja e caixa no Mercado Pago.
Vincule a maquininha a uma loja e a um caixa (Parte 2).
Este modelo de terminal não aceita o modo PDV (integrado).
Ative o modo pelo menu da maquininha (Mais opções › Configurações › Modo de vinculação).
Esta operadora não usa cadastro de maquininha no sistema.
Aparece para operadoras sem maquininha (ex.: Pix pela API do banco).
12. Perguntas frequentes
A configuração vale para todas as filiais?
Não. Chave, conta e maquininhas são por filial. Escolha a filial no topo da tela e configure cada uma.
Cada operador precisa configurar?
Só a maquininha padrão (“Usar como minha padrão”). A conta e as maquininhas são da filial.
Preciso clicar em Gravar depois de conectar?
Não. No GransoftWeb, ao responder Sim com a conta conectada, os tokens já são gravados.
O GransoftWeb obriga o uso da maquininha?
Não. Ele só aciona a maquininha quando a modalidade escolhida na baixa é integrada.
13. Conclusão
Com a chave, a conta conectada, as maquininhas e a modalidade integrada, a filial está pronta para cobrar pela maquininha a partir das parcelas do pedido.
