Integrar meio de pagamento: a forma de pagamento vem primeiro
Mercado Pago, PagSeguro, PagHiper, Efí (GerenciaNet) e Banco Inter seguem o mesmo roteiro — e ele tem um passo que não é óbvio.
A ORDEM CERTA:
1. Criar a conta na plataforma parceira, quando ainda não existe. No Banco Inter, a conta precisa ser PESSOA JURÍDICA.
2. Gerar a credencial lá, sempre na área de API/integrações da plataforma.
3. No ERP, cadastrar antes uma FORMA DE PAGAMENTO para identificar a integração, em Financeiro › Opções auxiliares › Formas de pagamento. Este é o passo esquecido — sem a forma de pagamento, não há onde a integração se encaixar, e as vendas continuam sem gerar a cobrança.
4. Abrir o aplicativo do parceiro em MEUS APLICATIVOS › Ver todos os aplicativos e informar a credencial.
O botão é Meus aplicativos, na tela inicial. Material antigo fala em "Configurações › Aplicativos"; o caminho de hoje é Meus aplicativos.
QUAL CREDENCIAL CADA UM PEDE
Essa é a dúvida mais concreta, porque cada plataforma dá um nome diferente à mesma coisa:
- EFÍ (antiga GerenciaNet) — CLIENT ID e CLIENT SECRET. No site da Efí você cria uma aplicação na área de API e copia os dois códigos.
- PAGHIPER — API KEY e TOKEN, na área de credenciais da sua conta. A conta precisa estar verificada; se os códigos não aparecem, há a opção de atualizar o token.
- PAGSEGURO — o E-MAIL da conta e o TOKEN gerado na área de integrações de venda online.
- MERCADO PAGO — PUBLIC KEY e ACCESS TOKEN, na área de credenciais do seu negócio.
- BANCO INTER — aqui não é código copiado: você cria uma aplicação no site do Inter, baixa o ARQUIVO de chaves e certificado e anexa esse arquivo no cadastro da integração.
O QUE MAIS A TELA DA INTEGRAÇÃO PEDE
Além da credencial, os campos com asterisco vermelho costumam ser: a forma de pagamento que você acabou de criar, os RECURSOS liberados (boleto, cartão ou os dois), DIAS PARA VENCIMENTO do boleto, máximo de parcelas e o PRAZO/TEMPO PARA SAQUE, além das taxas e tarifas.
Atenção a esses números: taxa, tarifa e prazo de repasse são o que VOCÊ combinou com a plataforma. Você os digita para o sistema calcular certo — o ERP não os define nem os negocia.
DEPOIS DE LIGADO
A forma de pagamento passa a ter a plataforma como INSTITUIÇÃO FINANCEIRA. Toda vez que a venda usar essa forma de pagamento, o sistema gera a cobrança pela plataforma. Na listagem de vendas, em Mais ações › Link de pagamento, sai o link para mandar ao cliente — e a venda precisa estar numa situação que gera movimentação no financeiro para isso aparecer.
O pagamento confirmado no parceiro atualiza a situação no ERP sozinho, inclusive o pedido da loja virtual.
QUANDO NÃO CONFIRMA
- a credencial pode ter expirado ou sido revogada no parceiro;
- a forma de pagamento pode não estar apontando para a integração certa;
- no Banco Inter, a aplicação precisa estar ATIVA no site do banco antes de começar a emitir; há uma espera até a ativação;
- há uma janela de alguns minutos entre o pagamento e o aviso.
Dá para ter mais de uma integração da mesma plataforma cadastrada, e cada uma se liga à sua forma de pagamento.
Taxas, prazo de repasse e limites são da plataforma parceira, não do ERP — a negociação é com ela.