O aplicativo Mercado Pago por dentro: os quatro campos da integração e o que as telas do app não fazem
O QUE VOCÊ ENCONTRA AQUI
Muita gente abre o aplicativo do Mercado Pago dentro do sistema procurando um botão que não está lá e conclui que é falta de permissão. Quase sempre não é. O aplicativo é pequeno de propósito: tem telas próprias só para a integração e reaproveita telas do ERP para o resto. Aqui está o que existe nele, o que ele deliberadamente não oferece e o que fica com o ERP. O roteiro comum de integrar um meio de pagamento e o funcionamento do Pix estão na pasta Meios de pagamento.
OS QUATRO CAMPOS DO CADASTRO DA INTEGRAÇÃO
O formulário de Adicionar integração e o de Editar integração são o mesmo componente, e ele tem quatro campos. Esta é a lista completa e fechada: Forma de pagamento, que é uma seleção; Public Key, que é digitado; Access token, também digitado; e Tempo para saque, que é uma seleção com opções vindas do sistema. Não há mais nada nessa tela. Não existe campo de ambiente, de loja, de webhook, de taxa nem de descrição.
Forma de pagamento, Public Key e Access token são validados como obrigatórios: se ficarem vazios, o formulário marca o campo em erro e não salva. Tempo para saque aparece com a mesma marcação de obrigatório, mas a validação da tela não cobre esse campo, então ele pode ficar em Selecione sem que o formulário reclame. Se você espera um comportamento de saque e ele não aparece, volte na integração e confira esse campo.
POR QUE APARECE API KEY NA LISTA E POR QUE O TOKEN SOME
Essa é a confusão mais comum e não é erro seu. No formulário o campo se chama Public Key. Na listagem de integrações a mesma informação aparece na coluna com o rótulo API Key. É o mesmo dado, com dois nomes diferentes na interface.
Além disso, o valor aparece mascarado: o sistema mostra os quatro primeiros caracteres e substitui o resto por asteriscos. Isso vale na listagem e na tela de Visualizar.
E o Access token não aparece em lugar nenhum depois de salvo. A listagem tem essa coluna, mas ela está oculta, e na tela de Visualizar a linha do token não é exibida. Consequência prática: não dá para conferir nem copiar o token pelo sistema depois de gravado. Quem perdeu o token não recupera pelo ERP; gere uma credencial nova no portal do parceiro e cole no campo Access token da integração, editando o cadastro. Não envie token, chave ou senha por atendimento; se uma credencial for exposta na conversa, gere outra no portal.
O QUE A TELA DE INTEGRAÇÕES OFERECE
A tela de Integrações do aplicativo tem o botão Adicionar, uma busca simples por nome e, em cada linha, três ações: Visualizar, Editar e Deletar. É essa a lista de ações, fechada. Ao deletar, o sistema pede confirmação citando o nome da forma de pagamento daquela integração. Se a busca não encontrar nada, a tela responde "Nenhuma integração foi encontrada".
A tela de Visualizar mostra Forma de pagamento, Public Key mascarada, Cadastrado por, Cadastrado em e Modificado em. Só isso.
QUANDO A LOJA AINDA NÃO TEM INTEGRAÇÃO
Se a loja não tem nenhuma integração do Mercado Pago cadastrada, o aplicativo não mostra lista vazia com ações: ele exibe a apresentação da integração e dispara o aviso "Esta loja não está integrada ao Mercado Pago." Nesse estado o único botão oferecido é Adicionar integração. Se você só vê esse aviso, não é falta de permissão: a loja em que você está simplesmente não tem cadastro. O vínculo por loja e o efeito de remover uma integração estão no conteúdo geral de Integrações.
A TELA INICIAL DO APLICATIVO TEM DOIS CARDS
Ao entrar no aplicativo você vê dois cards, e só dois: Recebimentos e Integrações. Não há painel de vendas, relatório, conciliação nem configuração adicional ali. A tela inicial pode ainda exibir um aviso sobre a versão de demonstração do aplicativo; isso é assunto de plano e se resolve com o comercial.
RECEBIMENTOS E CLIENTES DENTRO DO APP SÃO TELAS DO ERP
Este é o ponto que mais gera dúvida. As telas de Recebimentos e de Clientes abertas de dentro do aplicativo não são telas do Mercado Pago. Elas levam você para o próprio ERP: os recebimentos abrem a tela de movimentações financeiras do financeiro, e clientes abre o cadastro de clientes do próprio sistema. As telas de listar, adicionar, editar e visualizar recebimento também reaproveitam os mesmos componentes do módulo financeiro.
Ou seja: lançar recebimento, confirmar, buscar por período, cadastrar cliente, tudo isso funciona igual ao ERP e está explicado no conteúdo do ERP.
DEZ RECURSOS QUE A LISTA DE RECEBIMENTOS DO APP NÃO OFERECE
Aqui está a diferença que faz parecer que você perdeu permissão. A lista de recebimentos aberta dentro do aplicativo do Mercado Pago é a mesma lista do financeiro, mas entra com dez recursos desligados pela própria tela. A lista é fechada e são estes: exportar, transferências, importar extrato, imprimir boletos, importar planilha, duplicar, emitir nota, imprimir fatura, imprimir recibo e compartilhar no WhatsApp.
Nada disso depende de permissão do usuário nesse contexto: a tela do aplicativo passa esses recursos como desligados, e todos eles vêm ligados por padrão na lista do financeiro. O mesmo item continua disponível na tela de recebimentos do ERP, fora do aplicativo. Então a orientação é simples: para qualquer um desses dez, saia do aplicativo e use a tela de recebimentos do financeiro.
Há ainda um detalhe a mais no formulário: ao adicionar ou editar um recebimento dentro do aplicativo, o campo Forma de pagamento não traz o atalho de cadastrar uma forma nova ali mesmo. Ele só busca formas já cadastradas. Para criar uma forma, vá ao cadastro de formas de pagamento do ERP.
Se o item que você procura não está nessa lista de dez e também não aparece na tela do ERP, aí sim vale investigar permissão — e isso é assunto do conteúdo sobre a tela de Permissões.
O AVISO QUE APARECE NA FORMA DE PAGAMENTO DO ERP
Quando você abre a edição de uma forma de pagamento cujo banco é uma integração, o ERP exibe no topo do formulário um aviso amarelo dizendo que algumas configurações devem ser realizadas através do aplicativo do Mercado Pago, com um link para gerenciar essa integração. Esse aviso aparece na edição, não no cadastro novo, e não é erro nem bloqueio: dá para salvar normalmente. Ele existe justamente para explicar por que credencial e tempo para saque não estão no cadastro da forma de pagamento — eles ficam no aplicativo.
O QUE COSTUMA DAR ERRADO
Campo obrigatório em branco. Se você clicar em salvar sem preencher Forma de pagamento, Public Key ou Access token, o campo fica marcado em erro e o cadastro não vai. Repare que Tempo para saque não entra nessa checagem, apesar de aparecer marcado como obrigatório.
Token colado com espaço. Copiar do portal costuma trazer espaço no começo ou no fim, ou uma quebra de linha. O campo grava exatamente o que foi colado — não existe limpeza automática de espaços. Na dúvida, apague o conteúdo e cole de novo com atenção. Como o token não pode ser lido depois de salvo, se restar dúvida gere uma credencial nova no portal do parceiro em vez de tentar adivinhar o que está gravado.
A forma de pagamento que você quer não aparece. Dentro do aplicativo, ao lançar ou editar um recebimento, a busca do campo Forma de pagamento não traz todas as formas da empresa: ela vai filtrada pelo Mercado Pago e só devolve formas de pagamento cujo banco é Mercado Pago. Vale ainda um detalhe dessa busca: quando a empresa tem mais de uma loja ativa, o sistema considera a loja em que o usuário está logado, então uma forma cuja conta bancária não está ligada àquela loja não aparece. Se a forma que você queria não está na lista — seja aqui, seja na seleção do cadastro da integração — o caminho é conferir no cadastro de formas de pagamento se ela existe e está com o banco Mercado Pago, e em que conta bancária e loja ela está. Isso está detalhado no conteúdo sobre o cadastro de formas de pagamento.
Tela de erro ao clicar no card Recebimentos. Se ao clicar nesse card aparecer a mensagem de que a página solicitada não foi encontrada no sistema, não é permissão nem falta de integração: o link que o card abre não corresponde a nenhuma tela do aplicativo. Abra os recebimentos pelo próprio ERP; a listagem é a mesma.
O QUE NÃO ENTRA AQUI
O roteiro geral de integrar um meio de pagamento e o funcionamento do Pix estão na pasta Meios de pagamento. O índice das integrações, o vínculo por loja e o efeito de remover estão no conteúdo geral de Integrações. O cadastro de forma de pagamento e a tela de Permissões têm conteúdo próprio. Cadastro de cliente e lançamento financeiro estão no conteúdo do ERP.