Como integrar o Mercado Pago com o Odoo ERP e automatizar seus pagamentos
Para integrar o Mercado Pago ao Odoo ERP, o caminho passa pela obtenção de credenciais de API no painel de desenvolvedores do Mercado Pago — o Access Token e a Public Key — e pela inserção dessas credenciais no módulo de pagamento do Odoo, com a configuração de webhooks para que o status dos pedidos seja atualizado de forma automática. O processo funciona tanto para lojas de e-commerce quanto para pontos de venda (PDV) com terminais como o Point Smart, e se aplica às versões 16, 17 e 18 do ERP.
Ao longo deste artigo, você vai encontrar o passo a passo completo desde a obtenção das credenciais até os testes em sandbox, além de uma comparação entre as três formas de integrar (módulo nativo, marketplace e desenvolvimento custom). Também abordamos os erros mais frequentes após a configuração inicial — com orientações práticas de resolução — e os cuidados com conformidade fiscal (NF-e) e proteção de dados (LGPD) que a maioria dos guias disponíveis ignora.
O que você precisa antes de integrar o Mercado Pago ao Odoo
Antes de iniciar a configuração, é preciso reunir credenciais, verificar a compatibilidade da sua versão do Odoo e garantir que o servidor atenda a requisitos técnicos de segurança.
Conta de desenvolvedor e credenciais de API no Mercado Pago
O primeiro passo é acessar o painel de desenvolvedores do Mercado Pago em developers.mercadopago.com.br e criar uma nova aplicação. Durante a criação, você escolhe entre “Pagamento online” (para e-commerce) ou “Pagamentos presenciais” (para PDV com Point Smart), o que determina quais credenciais serão geradas.
Após criar a aplicação, o painel exibe dois conjuntos de credenciais: um para ambiente de teste (sandbox) e outro para produção. Use as credenciais de teste durante o desenvolvimento e só substitua pelas de produção quando o fluxo estiver validado. Misturar esses ambientes é um dos erros mais comuns — e será retomado na seção de erros frequentes.
Versão do Odoo e módulos necessários
As versões 17 e 18 do Odoo já incluem o provedor de pagamento Mercado Pago de forma nativa, sem necessidade de instalar módulos adicionais. A versão 16 tem suporte parcial; versões anteriores (13 a 15) dependem de módulos de terceiros disponíveis no marketplace ou no GitHub.
Independentemente da versão, os módulos de Contabilidade e Faturamento precisam estar ativos no Odoo. Sem eles, o registro contábil dos pagamentos recebidos via Mercado Pago não funciona de forma correta, o que pode gerar inconsistências no fechamento financeiro.
Requisitos de infraestrutura e segurança do servidor
O servidor onde o Odoo está instalado precisa ter HTTPS com certificado SSL válido — não apenas por boas práticas, mas porque o Mercado Pago rejeita URLs de webhook que não usem conexão segura. Verifique também se o servidor tem acesso à internet para realizar chamadas à API do Mercado Pago.
Quanto ao armazenamento das credenciais, o Access Token nunca deve estar escrito de forma fixa no código-fonte (hardcoded). O recomendado é usar variáveis de ambiente ou um gerenciador de segredos, o que reduz o risco de exposição em caso de vazamento do repositório.
Módulo nativo, marketplace ou desenvolvimento custom para integrar o Mercado Pago ao Odoo
Existem três caminhos para conectar o Mercado Pago ao Odoo, e a escolha depende da versão do ERP, do nível de personalização necessário e dos recursos técnicos disponíveis.
Módulo nativo do Odoo para o Mercado Pago
No Odoo 17 e 18, o Mercado Pago já aparece como provedor de pagamento na lista de configurações. Basta ativar o provedor e inserir o Access Token para que o fluxo padrão de e-commerce funcione. Para PDV, o caminho é diferente — a configuração passa pelo menu de terminais de pagamento, onde o Point Smart é reconhecido de forma automática após a associação com a loja.
Essa opção cobre a maioria dos casos de uso sem exigir conhecimento técnico avançado. A limitação está em fluxos mais complexos, como cobranças recorrentes ou divisão de pagamentos entre múltiplos recebedores.
Módulos de terceiros no marketplace e GitHub
O Odoo Apps Store e repositórios no GitHub oferecem módulos desenvolvidos pela comunidade com funcionalidades extras: conciliação automática de pagamentos, suporte a versões anteriores do Odoo e integrações com outros meios de pagamento brasileiros como Pix e boleto. Antes de instalar qualquer módulo de terceiro, vale verificar a compatibilidade com a sua versão do Odoo, a frequência de atualizações do repositório e as avaliações de quem já usou.
Um módulo desatualizado pode quebrar após uma atualização do Odoo ou após mudanças na API do Mercado Pago. Por isso, prefira módulos com histórico de manutenção ativo e documentação clara.
Desenvolvimento personalizado com SDK e API
O desenvolvimento custom faz sentido quando o negócio tem fluxos específicos que os módulos prontos não atendem: cobrança recorrente com lógica própria, split de pagamento entre parceiros ou integrações com sistemas legados. Nesse caso, o trabalho envolve o uso do SDK do Mercado Pago para Python, o framework do Odoo e a criação de endpoints customizados para receber webhooks.
Esse caminho exige uma equipe técnica capacitada e um compromisso com manutenção contínua, já que as APIs do Mercado Pago evoluem e as versões do Odoo são atualizadas com regularidade. O custo de manutenção deve entrar no cálculo antes de optar por esse modelo.
Passo a passo para configurar o Mercado Pago no Odoo ERP
Com as credenciais em mãos e o método de integração definido, o próximo passo é configurar tudo dentro do Odoo e validar o funcionamento antes de ir para produção.
Como ativar o provedor de pagamento e inserir as credenciais
Para e-commerce, siga este caminho dentro do Odoo:
- Acesse Vendas > Configuração > Provedores de serviços de pagamento
- Localize o Mercado Pago na lista e clique em Ativar
- Abra a aba Credenciais e insira o Access Token obtido no painel de desenvolvedores
- Selecione o país (Brasil) e salve as configurações
- Defina os métodos de pagamento aceitos (cartão de crédito, Pix, boleto) conforme a sua aplicação
Para PDV com Point Smart, o caminho é: Ponto de Venda > Configuração > Ajustes > Terminais de pagamento. Após ativar o Mercado Pago como terminal, insira o Access Token e o número de série do dispositivo Point Smart.
Como configurar webhooks para notificações em tempo real
Os webhooks são notificações automáticas que o Mercado Pago envia ao Odoo sempre que o status de um pagamento muda — de pendente para aprovado, por exemplo. Sem essa configuração, o Odoo não atualiza o pedido de forma automática.
Para configurar:
- No painel do Mercado Pago, acesse as configurações da sua aplicação
- Insira a URL de notificação do Odoo — o formato costuma ser https://seudominio.com/payment/mercadopago/webhook
- Gere e copie a chave secreta do webhook, que autentica as notificações recebidas
- No Odoo, insira essa chave secreta no campo correspondente da configuração do provedor
- Selecione os eventos que devem disparar notificações (pagamento aprovado, recusado, cancelado)
A chave secreta é o mecanismo que impede que terceiros enviem notificações falsas ao seu servidor. Não a deixe em branco.
Como testar o fluxo completo no ambiente sandbox
Com as credenciais de teste ativas, o fluxo de validação segue estas etapas:
- Crie um pedido de teste no Odoo como se fosse uma venda real
- Avance para o checkout — o Odoo deve redirecionar ao ambiente de pagamento do Mercado Pago
- Use um dos cartões de teste disponíveis na documentação do Mercado Pago para simular um pagamento aprovado
- Verifique se o webhook disparou e se o status do pedido no Odoo foi atualizado
- Repita o teste simulando um pagamento recusado para confirmar que o fluxo de erro também funciona
Só migre para as credenciais de produção após validar todos os cenários no sandbox. Essa etapa evita surpresas com pedidos reais sem atualização de status.
Erros comuns na integração do Mercado Pago com o Odoo e como resolver
Mesmo após a configuração inicial, alguns problemas aparecem na prática e não estão cobertos pela documentação oficial. Conhecê-los com antecedência reduz o tempo de diagnóstico.
Os erros mais frequentes são:
- Webhook não dispara notificações: verifique se a URL de notificação está acessível pela internet (não pode ser localhost), se o certificado SSL é válido e se a chave secreta está correta no Odoo e no painel do Mercado Pago
- Token de sandbox usado em produção: confira o ambiente ativo na sua aplicação no painel do Mercado Pago — é um erro fácil de cometer ao fazer a transição entre fases
- Módulo incompatível com a versão do Odoo: módulos de terceiros têm versões específicas; instalar um módulo da versão 16 em uma instância 17 pode causar erros silenciosos ou quebrar funcionalidades existentes
- Pagamento confirmado no Mercado Pago, mas pedido não atualizado no Odoo: em geral indica falha na entrega do webhook — consulte os logs do servidor e do Odoo para identificar se a requisição chegou e qual foi a resposta
- Erro de certificado SSL: o Mercado Pago não aceita URLs com certificados autoassinados ou expirados; renove o certificado e teste novamente
- Timeout nas chamadas de API: revise a latência do servidor e verifique se os limites de requisição da API do Mercado Pago estão sendo respeitados — exceder o rate limit pode causar falhas intermitentes
Para além de resolver os erros pontuais, vale implementar um sistema de logs estruturado que registre cada chamada à API e cada notificação de webhook recebida. Com logs detalhados, o diagnóstico de problemas futuros se torna muito mais ágil — e a equipe técnica ganha visibilidade sobre o comportamento real da integração em produção.
Conformidade fiscal e LGPD na integração com o Mercado Pago no Odoo
Um aspecto que a maioria dos guias de integração ignora é a camada fiscal e de proteção de dados. No Brasil, ela faz parte do fluxo operacional — não é um detalhe opcional.
Do ponto de vista fiscal, a integração de pagamentos precisa estar alinhada com a emissão de Nota Fiscal Eletrônica (NF-e). O Odoo pode ser configurado com módulos de localização brasileira que habilitam a emissão fiscal dentro do próprio ERP. O pagamento registrado via Mercado Pago deve refletir de forma correta nos lançamentos contábeis — valor recebido, taxas descontadas e data de liquidação — para que o fechamento financeiro seja preciso.
Quanto à LGPD (Lei Geral de Proteção de Dados), os dados de clientes e transações que trafegam entre o Mercado Pago e o Odoo precisam receber tratamento adequado. Isso inclui coletar apenas os dados estritamente necessários para o processamento do pagamento, armazená-los com controles de acesso adequados e garantir que a política de privacidade do negócio descreva esse fluxo de dados de forma clara.
Embora as responsabilidades jurídicas variem conforme o modelo de negócio, a recomendação geral é consultar um profissional especializado em privacidade para mapear os dados que transitam pela integração. O Odoo permite configurar níveis de acesso por usuário, o que ajuda a restringir quem pode visualizar dados sensíveis de transações. Manter registros de auditoria também pode ser exigido dependendo do setor de atuação.
Perguntas frequentes sobre a integração do Mercado Pago com o Odoo ERP
Quais versões do Odoo têm módulo nativo para o Mercado Pago?
O Odoo 17 e 18 incluem o provedor de pagamento Mercado Pago de forma nativa, sem necessidade de módulos adicionais. Versões anteriores, da 13 à 16, podem exigir módulos de terceiros disponíveis no Odoo Apps Store ou em repositórios no GitHub — sempre com atenção à compatibilidade e ao histórico de atualizações do módulo.
É possível testar a integração antes de receber pagamentos reais?
O Mercado Pago oferece um ambiente sandbox com credenciais de teste separadas das de produção. Com elas, você simula pagamentos completos — incluindo aprovação, recusa e cancelamento — sem movimentar dinheiro real, e valida se o webhook atualiza o status dos pedidos no Odoo de forma correta.
A integração funciona tanto para e-commerce quanto para ponto de venda?
O Odoo suporta o Mercado Pago como provedor de pagamento online (e-commerce) e como terminal de pagamento presencial (PDV) com dispositivos Point Smart. As duas modalidades seguem caminhos de configuração distintos dentro do ERP, mas compartilham a mesma base de credenciais da aplicação criada no painel de desenvolvedores.
O que fazer se o webhook do Mercado Pago não atualizar o pedido no Odoo?
Verifique primeiro se a URL de notificação está acessível pela internet e se o certificado SSL do servidor é válido. Em seguida, confirme que a chave secreta do webhook está correta tanto no painel do Mercado Pago quanto no Odoo. Consulte os logs do servidor para identificar se a requisição chegou e qual foi a resposta retornada — isso costuma apontar o ponto exato da falha.
Com a integração configurada e validada em sandbox, o próximo passo natural é explorar o app do Mercado Pago para acompanhar cobranças, conciliar recebimentos e monitorar o fluxo financeiro em tempo real. O app do Mercado Pago oferece uma visão consolidada das transações que complementa bem os relatórios do Odoo, sobretudo para negócios que operam tanto no online quanto no presencial com Point Smart.
Consulte condições e tarifas em:
