Integrar o Mercado Pago ao Bling ERP acontece por meio das APIs dos dois sistemas e pode ser feita de três formas: pela conexão nativa disponível no painel do Bling, por um script ou middleware desenvolvido sob medida, ou com ferramentas de automação sem código como Pluga ou Make. Em qualquer dos caminhos, o processo exige credenciais válidas de ambos os lados — o Access Token do Mercado Pago e a API Key do Bling — além da configuração de webhooks para que os eventos de pagamento disparem ações no ERP em tempo real.
Ao longo deste artigo, você vai encontrar os pré-requisitos técnicos para começar, o passo a passo detalhado de cada etapa de configuração, uma explicação de como funciona o fluxo de sincronização de dados e uma seção de troubleshooting com os erros mais comuns — e suas soluções — que surgem durante esse processo.
O que a integração entre Mercado Pago e Bling ERP faz pela sua PME
Quem gerencia uma pequena ou média empresa conhece bem o custo de conferir o extrato do Mercado Pago linha a linha para cruzar com os pedidos do ERP. Esse trabalho manual consome tempo, gera inconsistências e deixa a conciliação financeira sempre atrasada. Com a integração ativa, cada pagamento aprovado no Mercado Pago cria ou atualiza um pedido no Bling de forma automática, eliminando esse processo de conferência manual.
A baixa de estoque é outro ponto crítico para PMEs. Esquecer de registrar a saída de um produto após a venda pode gerar vendas de itens indisponíveis — um problema que afeta diretamente a experiência do cliente. Ao conectar os dois sistemas, a atualização do estoque acontece a partir do evento de pagamento, sem depender de uma ação humana para cada transação.
O terceiro ganho concreto é a emissão de NF-e. O Bling permite configurar gatilhos internos que disparam a nota fiscal quando o pedido muda de status. Com a integração ao Mercado Pago, a aprovação do pagamento atualiza esse status e inicia o processo fiscal sem intervenção manual — o que reduz o risco de notas atrasadas ou esquecidas.
Pré-requisitos para integrar Mercado Pago ao Bling ERP
Antes de iniciar a configuração, é preciso garantir que tanto o lado do Mercado Pago quanto o do Bling estejam preparados para a conexão. Confira o que ter em mãos.
Contas ativas e credenciais necessárias
Do lado do Mercado Pago, é necessário ter uma conta ativa com acesso ao painel de desenvolvedores — o Mercado Pago Developers. A partir daí, você cria uma aplicação e obtém o Access Token e a Public Key, que são as credenciais usadas para autenticar as chamadas à API. Contas de teste também estão disponíveis no painel para validar a integração antes de colocar em produção.
Do lado do Bling, é preciso ter um plano ativo que permita integrações via API. Os planos intermediários e avançados do Bling costumam incluir esse acesso. A API Key do Bling fica disponível na seção de Preferências ou Integrações do painel, e pode ser gerada ou regenerada a qualquer momento pelo administrador da conta.
Infraestrutura técnica mínima
Para quem opta pela integração via API direta — sem ferramentas intermediárias —, o ambiente precisa de um servidor com suporte a HTTPS e capacidade de receber requisições POST (para os webhooks). Conhecimento básico em APIs REST e no formato JSON é necessário para escrever ou adaptar o código que vai intermediar a comunicação entre os dois sistemas.
Para PMEs sem equipe técnica, ferramentas de automação como Pluga ou Make oferecem conectores prontos que dispensam programação. Elas atuam como middleware visual, mapeando os campos de um sistema para o outro por meio de interface gráfica. A escolha entre as abordagens depende do volume de transações e do grau de personalização que a operação exige.
Passo a passo para configurar a integração Mercado Pago e Bling
Com os pré-requisitos prontos, o processo de integração segue quatro etapas. Cada uma envolve configurações em um dos dois lados — ou em ambos.
Etapa 1: gerar credenciais no painel de desenvolvedores do Mercado Pago
Acesse o Mercado Pago Developers em developers.mercadopago.com e faça login com a conta da sua empresa. No painel, siga estes passos:
- Clique em “Criar aplicação” e preencha o nome e a finalidade da integração.
- Selecione o modelo de integração — para este caso, “Pagamentos online” atende ao fluxo com o Bling.
- Após criar a aplicação, acesse a aba “Credenciais de produção” para copiar o Access Token e a Public Key.
Guarde o Access Token em um local seguro, pois ele dá acesso à sua conta de forma programática. Nunca exponha essa chave em código público ou repositórios abertos. Em ambientes de teste, use as credenciais de sandbox disponíveis na mesma tela.
Etapa 2: configurar webhooks para notificações de pagamento
Webhooks são notificações automáticas que o Mercado Pago envia para uma URL definida por você sempre que um evento ocorre — como a aprovação ou a recusa de um pagamento. Para configurá-los, acesse a seção “Webhooks” dentro da sua aplicação no painel de desenvolvedores e siga estes passos:
- Informe a URL de callback do seu middleware ou servidor. Essa URL precisa ser HTTPS válida e acessível publicamente.
- Selecione os eventos que deseja monitorar: payment.created e payment.updated são os mais relevantes para a integração com o Bling.
- Salve a configuração e use o botão de teste para verificar se o servidor responde com status HTTP 200.
Sem o retorno 200, o Mercado Pago interpreta que a notificação não foi recebida e tenta reenviar. Esse comportamento pode gerar duplicidade de eventos se o servidor processar a requisição mas não responder corretamente — um ponto de atenção que será retomado na seção de erros comuns.
Etapa 3: obter e ativar a chave de API no Bling ERP
No painel do Bling, acesse o menu Preferências e depois a seção “Integrações” ou “API”. Ali você encontra a opção de gerar uma nova API Key para a sua conta. Copie a chave gerada e armazene-a junto com as credenciais do Mercado Pago.
Verifique se o plano contratado no Bling tem o uso da API habilitado. Caso a chave não apareça ou o acesso esteja bloqueado, o suporte do Bling pode confirmar se o plano atual inclui esse recurso. Alguns planos exigem ativação manual da funcionalidade de API.
Etapa 4: conectar as APIs e mapear os campos de dados
Com as credenciais dos dois sistemas em mãos, o próximo passo é criar a lógica de conexão. O fluxo funciona da seguinte forma: o webhook do Mercado Pago dispara uma notificação com o ID do pagamento → o middleware faz uma chamada GET à API do Mercado Pago para buscar os detalhes completos → com esses dados, faz uma chamada POST ao endpoint /v2/pedidos do Bling para criar o pedido.
O mapeamento de campos entre as duas APIs é o ponto mais crítico dessa etapa. Os campos que precisam ser conectados incluem:
- ID do pagamento (Mercado Pago) → referência externa do pedido (Bling)
- Valor total do pagamento → valor do pedido
- Status do pagamento (approved, rejected, refunded) → status do pedido no Bling
- Nome e e-mail do comprador → dados do contato no Bling
- Itens do carrinho (quando disponíveis) → produtos do pedido
Para os campos que a API do Mercado Pago não retorna em todas as transações — como CPF do comprador —, o middleware precisa lidar com valores ausentes sem travar o processo. Definir valores padrão ou campos opcionais no Bling para esses casos evita erros de criação de pedido.
Como funciona a sincronização automática entre Mercado Pago e Bling
Com a integração ativa, cada evento de pagamento no Mercado Pago pode disparar ações automáticas no Bling. Veja como esse fluxo funciona na prática.
Fluxo de dados em tempo real via webhooks
O ciclo completo de uma transação aprovada segue esta sequência: o cliente conclui o pagamento no Mercado Pago → o sistema envia uma notificação webhook para a URL configurada → o middleware recebe o evento, consulta os detalhes do pagamento via API e cria o pedido no Bling com o status correspondente. Todo esse caminho ocorre em segundos, sem nenhuma ação manual no meio.
O mesmo fluxo cobre situações de estorno e recusa. Quando um pagamento é recusado ou revertido, o Mercado Pago envia um evento payment.updated com o novo status. O middleware captura essa atualização e altera o status do pedido no Bling, mantendo os dois sistemas alinhados sem necessidade de intervenção.
Automação de estoque e emissão de NF-e
A partir do pedido criado no Bling, entram em cena as regras automáticas do próprio ERP. O Bling permite configurar gatilhos internos que executam ações quando um pedido atinge determinado status — como dar baixa no estoque ao confirmar o pagamento ou iniciar a emissão da nota fiscal eletrônica quando o pedido passa para “em separação” ou “faturado”.
Essa configuração fica dentro do painel do Bling, na seção de automações ou regras de pedido. Para PMEs que trabalham com alto volume de transações, esse encadeamento de ações — pagamento aprovado → pedido criado → estoque atualizado → NF-e emitida — representa uma redução considerável no tempo dedicado a tarefas operacionais.
Erros comuns na integração Mercado Pago com Bling e como resolver
Mesmo com a configuração correta, alguns problemas surgem com frequência durante a operação da integração. Identificar cada um deles com antecedência reduz o tempo de diagnóstico quando algo sai do esperado.
Os erros mais recorrentes são:
- Access Token expirado ou com escopos insuficientes. O token gerado no painel de desenvolvedores pode ter permissões limitadas ou ter sido regenerado sem atualização no middleware. A solução é acessar o Mercado Pago Developers, verificar os escopos atribuídos à aplicação e substituir o token no ambiente de produção.
- Webhook sem resposta do servidor. Se a URL de callback não estiver acessível publicamente, não tiver HTTPS válido ou o servidor não retornar status 200, o Mercado Pago tentará reenviar a notificação várias vezes. Verificar os logs do servidor e testar a URL diretamente pelo painel de desenvolvedores ajuda a identificar o problema.
- Pedidos duplicados no Bling. Esse erro acontece quando o webhook é recebido mais de uma vez para o mesmo pagamento — situação possível se o servidor demorar para responder. A solução é implementar controle de idempotência: antes de criar o pedido, o middleware verifica se já existe um pedido no Bling com aquele ID de pagamento como referência externa.
- Dados do comprador incompletos. A API do Mercado Pago nem sempre retorna todos os campos de identificação do comprador, o que pode causar falha na criação do pedido no Bling se campos obrigatórios estiverem em branco. Mapear esses campos como opcionais no Bling ou definir valores padrão no middleware resolve o bloqueio.
- Erro de autenticação na API do Bling. Se a API Key estiver inativa, revogada ou pertencer a um plano sem acesso à API, as chamadas ao Bling retornarão erro 401 ou 403. Verificar o status da chave no painel do Bling e confirmar se o plano inclui integrações via API são os primeiros passos para resolver.
Manter um log detalhado de cada chamada entre os sistemas — com timestamp, payload e resposta — é a prática mais eficaz para diagnosticar qualquer um desses erros sem precisar reproduzir o problema do zero.
Perguntas frequentes sobre a integração Mercado Pago com Bling ERP
Preciso saber programar para integrar o Mercado Pago ao Bling?
Não é obrigatório. Ferramentas de automação como Pluga e Make oferecem conectores visuais que permitem ligar as duas APIs sem escrever código. Para integrações com alto volume de transações ou com lógica de negócio mais complexa, conhecimento em APIs REST e JSON pode ser necessário para cobrir cenários que as ferramentas sem código não atendem.
A integração funciona para vendas feitas com Pix e cartão de crédito?
A API do Mercado Pago notifica sobre pagamentos independentemente do meio utilizado — Pix, cartão de crédito, boleto ou outros. O webhook envia o evento de pagamento aprovado com o meio de pagamento como um dos campos, e o middleware trata todos eles da mesma forma ao criar o pedido no Bling.
É possível emitir NF-e de forma automática após o pagamento ser aprovado?
O Bling permite configurar regras internas para que a emissão da NF-e seja disparada quando o pedido atinge um determinado status. Com a integração ao Mercado Pago, a aprovação do pagamento atualiza o status do pedido no Bling e pode iniciar esse processo fiscal sem nenhuma ação manual.
Qual plano do Bling permite a integração via API?
Os planos intermediários e avançados do Bling costumam incluir acesso à API e suporte a integrações com marketplaces e meios de pagamento. Consultar a página de planos do Bling é o caminho mais seguro para verificar qual opção atende ao volume e às necessidades da sua PME.
Com a integração configurada, o Mercado Pago e o Bling passam a trabalhar em conjunto, e cada venda recebida pelo app do Mercado Pago — seja pelo link de pagamento, pelo QR Code ou pela maquininha Point — alimenta o ERP de forma automática. Se você ainda não conhece todas as formas de recebimento que o Mercado Pago oferece para PMEs, vale explorar as opções disponíveis no app e avaliar quais se encaixam melhor no modelo de operação da sua empresa.
Consulte condições e tarifas em: