Mercado Pago: visão geral — o que ele faz, o que ele não faz e onde está cada resposta
COMECE POR AQUI
Esta fonte é o mapa do Mercado Pago dentro do sistema. Ela diz o que a integração é, o que já está confirmado que ela faz, o que ela não faz e para qual fonte ir em cada dúvida. Ela não repete o roteiro comum de integrar um meio de pagamento nem o funcionamento geral do Pix: isso está na pasta Meios de pagamento.
O QUE O MERCADO PAGO É DENTRO DO SISTEMA
Ele não entra como um gateway à parte. O financeiro trata o Mercado Pago como uma integração bancária: ele aparece com nome próprio na lista de bancos da forma de pagamento, ao lado dos bancos tradicionais. Além disso ele tem um aplicativo próprio dentro do sistema, cuja tela inicial traz dois cards: Recebimentos e Integrações.
O Mercado Pago aparece em três lugares diferentes, e cada um tem regra própria:
1. no aplicativo do Mercado Pago, onde a integração é cadastrada com as credenciais;
2. no financeiro, quando você manda gerar a cobrança de um recebimento;
3. na loja virtual, como meio de pagamento do checkout.
Confundir os três é a causa mais comum de resposta errada. Antes de orientar, descubra em qual deles o cliente está.
NÃO CONFUNDA COM O MERCADO LIVRE
São duas integrações diferentes, da mesma empresa, com finalidades distintas. O Mercado Pago é meio de pagamento: recebe dinheiro. O Mercado Livre é canal de venda: traz pedidos do marketplace. Ter um não significa ter o outro, e o cliente troca os nomes com frequência. Confirme qual dos dois antes de dar qualquer caminho.
O PRÉ-REQUISITO QUE DERRUBA A MAIORIA DOS CHAMADOS
Cadastrar a integração não basta. Antes de qualquer cobrança sair, precisa existir uma FORMA DE PAGAMENTO apontando para o Mercado Pago — é o primeiro campo do cadastro da integração. Na hora de escolher, a lista só oferece formas de pagamento sem banco ou que já estejam com o banco Mercado Pago. Se a forma que o cliente quer não aparece nessa lista, ela já está presa a outra integração.
Para a loja virtual a exigência é maior: a forma de pagamento precisa apontar para uma conta bancária, e essa conta precisa estar vinculada à loja em que a pessoa está. O detalhe dessa corrente está na fonte da loja virtual.
O QUE ESTÁ CONFIRMADO QUE O SISTEMA NÃO FAZ
Esta lista é fechada e vale para hoje. Nenhum destes pontos é limitação do Mercado Pago: são do sistema.
1. Pix pela integração do Mercado Pago no financeiro não é gerado. O pedido passa pelas validações, chega no ponto de gerar e volta vazio, sem QR Code e sem mensagem de erro.
2. Não existe checkout transparente do Mercado Pago. Não prometa preenchimento de cartão dentro da loja virtual.
3. Parcelamento e desconto à vista não são editáveis no formulário da integração: ele tem quatro campos, e nenhum deles é de parcelamento.
4. A confirmação automática do pedido pago na loja virtual não é confiável. Ela depende de uma lista fechada de condições, e na prática o pedido costuma continuar na situação em que estava.
Para boleto, o Mercado Pago segue o caminho normal da integração.
ONDE ESTÁ CADA RESPOSTA
Cadastro da integração, os quatro campos, o token que não pode ser relido depois de salvo, as telas do aplicativo e os dez recursos que a lista de recebimentos do app não oferece: fonte "O aplicativo Mercado Pago por dentro".
Gerar a cobrança de um recebimento, as três checagens em ordem, as mensagens de erro de cada uma e o caso do Pix: fonte "Cobrar pelo Mercado Pago num recebimento".
Sumiu do checkout, desativou sozinho, parcelamento que a loja mostra e pedido pago que não muda de situação: fonte "Mercado Pago na loja virtual".
Quem pode ver e mexer em cada coisa, e por que os recebimentos seguem as permissões do Financeiro: fonte "Mercado Pago: as permissões do aplicativo".
O QUE NÃO É DAQUI
Roteiro comum de integrar um meio de pagamento e funcionamento geral do Pix: pasta Meios de pagamento. Desenho comum dos canais de venda, de-para de situações e dono do pedido, do estoque e do preço: pasta Marketplaces e e-commerce. Vínculo da integração por loja, efeito de remover uma integração e "Gerar venda": fonte geral de Integrações. Cadastro de cliente, de forma de pagamento, de conta bancária e o lançamento financeiro em si são do ERP e se respondem pelas fontes do ERP.
Taxas, prazos de repasse, limites e aprovação de conta são contrato seu com o Mercado Pago, e os passos dentro do portal dele mudam sem aviso. Não envie token, chave ou senha em atendimento; se você já colou uma credencial em algum lugar, gere outra no portal do parceiro.
O QUE COSTUMA DAR ERRADO
"Integrei e não funciona": confirme primeiro em qual dos três lugares, e comece pela forma de pagamento apontando para a integração.
"Parou do nada": na loja virtual quase sempre alguém mexeu na forma de pagamento ou na conta bancária; no financeiro costuma ser credencial trocada ou revogada no portal do parceiro.
"Está ativo e não gera nada": na Gestão de Cobranças, ativo significa apenas que existe forma de pagamento com o banco Mercado Pago. Não é prova de credencial válida.
"Não acho a permissão do Mercado Pago": a tela de permissões precisa ser aberta de dentro do aplicativo.