Cobrar pelo Mercado Pago num recebimento: boleto e o caso do Pix

Atualizado em 22/10/2026

O QUE O MERCADO PAGO É DENTRO DO SISTEMA

O Mercado Pago não entra no ERP como um "gateway à parte": ele é tratado como uma integração bancária do financeiro. Aparece com nome próprio na lista de bancos da forma de pagamento, ao lado de Banco do Brasil, Itaú, Bradesco e companhia, e na conta bancária ele responde pelo código bancário 323.

Quem gera a cobrança é o mesmo caminho que gera boleto de banco. O sistema olha o banco gravado na forma de pagamento do lançamento e, a partir dele, decide qual integração chamar — se não houver integração para aquele banco, o caminho vira boleto em PDF. Por isso vale aqui a regra comum a todo meio de pagamento: antes de qualquer cobrança sair, precisa existir uma forma de pagamento apontando para o Mercado Pago. Na hora de escolher, a lista só oferece formas de pagamento sem banco ou que já estejam com o banco Mercado Pago; uma forma presa a outra integração não aparece. O roteiro geral de integrar um meio de pagamento tem fonte própria e não se repete aqui; esta trata só do que é específico do Mercado Pago.

AS TRÊS CHECAGENS ANTES DE GERAR A COBRANÇA

Toda vez que o sistema recebe o pedido de gerar a cobrança, ele faz três checagens, sempre nesta ordem, e cada uma tem mensagem própria. Saber a ordem é o que resolve o atendimento rápido: a mensagem já diz em qual delas parou.

Primeira, a forma de pagamento. O lançamento precisa estar numa forma de pagamento marcada como boleto ou cartão. Se não estiver, a resposta é "Este lançamento não está vinculado a uma forma de pagamento válida!". A mesma mensagem aparece quando o lançamento não tem forma de pagamento nenhuma. Para a solicitação de Pix a exigência é outra: a forma precisa estar marcada como Pix ou cartão.

Segunda, a liberação do aplicativo. O Mercado Pago precisa estar liberado para a empresa e para a loja do lançamento. Isso é o que mais engana: a validação não é só por empresa, é pela loja gravada naquele lançamento. Um recebimento de outra loja pode ser recusado mesmo com tudo funcionando na loja principal. Quando trava aqui, a mensagem é a do plano e cita a integração com o Mercado Pago ("O seu plano atual não lhe permite utilizar a integração com o Mercado Pago...").

Terceira, a permissão do usuário. Quem está logado precisa ter permissão de imprimir boleto, ou de imprimir Pix quando o pedido é de Pix. Sem ela vem "Você não tem permissão para acessar esta área!". Permissão de imprimir boleto tem fonte própria, consulte lá.

Passadas as três, ainda barram: lançamento já baixado devolve "Este lançamento já foi pago!", e forma de pagamento sem banco preenchido devolve "Forma de pagamento ... não vinculada a integração!".

Um detalhe que economiza atendimento: essas mensagens detalhadas só saem para o usuário logado na mesma empresa do lançamento. Quando quem abre é o cliente final, pelo link público da cobrança, qualquer uma dessas recusas vira a mesma frase genérica — "Este lançamento não está disponível!". Cliente relatando essa frase não indica nada por si só; é preciso repetir a operação de dentro do sistema para ver a mensagem real.

O CASO DO PIX

Este é o ponto mais importante desta fonte. O caminho que efetivamente gera Pix no financeiro tem tratamento para o Banco Inter, a Efí (GerenciaNet), a PagHiper, a Conta Integrada e as integrações que rodam pelo módulo bancário externo (Asaas, Banco do Brasil, C6). O Mercado Pago não está entre eles.

Na prática: hoje o Pix pela integração do Mercado Pago não é gerado pelo sistema. A solicitação passa pelas validações, chega no ponto de gerar e volta vazia. O cliente vê a tela sem o Pix, sem QR Code e sem mensagem de erro. Não é credencial errada, não é dado do cliente, não é a conta do parceiro e não adianta refazer o lançamento nem tentar de novo mais tarde — a integração sequer chega a ser chamada.

O que orientar: para cobrar por Pix, use uma das integrações que fazem Pix. Para boleto, o Mercado Pago segue o caminho normal da integração. O funcionamento geral do Pix no sistema tem fonte própria e não se repete aqui.

O CARD "ATIVO" DA GESTÃO DE COBRANÇAS ENGANA

Na lista de meios de pagamento da Gestão de Cobranças cada integração aparece marcada como ativa ou não. O Mercado Pago é marcado como ativo apenas porque existe alguma forma de pagamento com o banco Mercado Pago gravado. Só isso. O sistema não verifica se as credenciais foram preenchidas, nem se ainda funcionam.

Por isso é comum o cliente dizer "aqui está ativo e não funciona". Está ativo mesmo, mas ativo ali significa apenas que a forma de pagamento existe. Nunca use esse indicador como prova de que a integração está configurada.

O QUE COSTUMA DAR ERRADO

Quando o cliente diz que gerou a cobrança e deu erro, siga nesta ordem.

Um. A forma de pagamento do lançamento é a que aponta para o Mercado Pago e está marcada como boleto ou cartão? Se a cobrança pretendida é Pix, pule para o item quatro.

Dois. O aplicativo está liberado para a loja daquele lançamento, e não só para a empresa? Confira a loja gravada no lançamento, não a loja do usuário que está tentando.

Três. A credencial continua válida no portal do Mercado Pago? Credencial revogada, trocada ou de outra conta derruba a geração mesmo com tudo certo no ERP. Nunca peça a credencial ao cliente e nunca repita uma que ele tenha colado no chamado. Se ele colar, oriente a descartar aquela e gerar outra no portal do parceiro.

Quatro. É Pix? Então não sai, pelo motivo explicado na seção acima.

DOIS DETALHES QUE APARECEM NO ATENDIMENTO

Recebimento que já tem transação registrada na integração não pode ser agrupado com outros. O sistema recusa dizendo que aquele recebimento possui integração com o Mercado Pago, por isso não é possível agrupar.

Clicar duas vezes seguidas em gerar o boleto não acelera nada. O sistema guarda o horário da última emissão daquele lançamento e, se a nova tentativa vier em menos de quinze segundos, ele espera antes de seguir. A tela parece travada e não está. Essa espera vale para a emissão de boleto pela integração.