Ir para conteúdo
Integrações / Gateways / Mercado Pago

Integração com o
Mercado Pago
para e-commerce
e marketplaces

Desenvolvimento de integração com a API do Mercado Pago para checkout transparente, Pix, split em marketplaces e sistemas que precisam de conexão direta com o gateway.

Checkout APISDK oficialPixSplit MarketplaceParcelamentoIPN WebhooksSandbox
Sobre o Mercado Pago

O gateway e sua API

O Mercado Pago é o gateway do grupo Mercado Livre e um dos mais utilizados no Brasil. Sua API REST suporta cartão de crédito e débito, Pix, boleto e parcelamento com e sem juros, com autenticação via access token OAuth. Para developers, disponibiliza SDKs oficiais em PHP, Node.js, Python, Ruby, Java e .NET.

Para marketplaces, o diferencial está no Marketplace API — um modelo onde o marketplace recebe o pagamento e distribui automaticamente para os vendedores conectados via OAuth. Cada vendedor precisa autorizar a conexão com o marketplace, o que cria um fluxo de onboarding que precisa ser considerado no escopo da integração.

Um ponto técnico importante: o Checkout Transparente do Mercado Pago utiliza o MercadoPago.js para tokenizar o cartão no frontend sem que os dados trafeguem pelo servidor. Isso simplifica a conformidade com PCI-DSS, mas exige atenção na implementação para que a tokenização aconteça corretamente antes do envio ao backend.

O que a integração cobre

Aspectos técnicos
do desenvolvimento

Checkout Transparente (API)

O cliente preenche os dados de pagamento dentro do seu site via MercadoPago.js, que tokeniza o cartão no frontend. O backend processa a cobrança com o token gerado — sem redirecionamento, sem exposição dos dados do cartão.

SDKs para múltiplas linguagens

O Mercado Pago disponibiliza SDKs oficiais para PHP, Node.js, Python, Ruby, Java e .NET. O desenvolvimento pode aproveitar o SDK da linguagem do seu backend, reduzindo o volume de código necessário para a integração.

Split para marketplace

O Marketplace API do Mercado Pago permite dividir automaticamente o valor de uma transação entre múltiplos recebedores. Os vendedores conectam suas contas via OAuth e o split é aplicado na própria transação.

Pix e parcelamento

A integração suporta Pix com QR Code dinâmico e parcelamento com e sem juros. As regras de parcelamento são configuradas na conta do Mercado Pago e refletidas automaticamente no checkout.

Webhooks de notificação

O Mercado Pago envia notificações IPN (Instant Payment Notification) para um endpoint configurado quando o status de uma transação muda. A integração inclui o endpoint receptor com validação e atualização automática.

Sandbox completo

Ambiente de testes com usuários e cartões fictícios para simular todos os cenários — aprovação, recusa, Pix, boleto e marketplace — antes de qualquer transação real.

Integração via API

Por que não usar
um plugin pronto

Quando um plugin é suficiente

O Mercado Pago tem plugin oficial para WooCommerce com manutenção ativa e boa cobertura de funcionalidades. Para casos de uso padrão em WooCommerce, o plugin pode ser a escolha mais rápida.

Quando a integração direta é necessária

  • Você tem um marketplace e precisa do Marketplace API com split
  • Sua plataforma não tem módulo oficial atualizado
  • Você opera com sistema próprio, ERP ou app sem suporte a plugins
  • Precisa de controle sobre o fluxo de onboarding OAuth dos vendedores
  • Seu checkout tem design próprio incompatível com o widget padrão
  • Precisa combinar Pix, boleto e cartão no mesmo fluxo customizado
  • Quer logs detalhados e controle sobre tratamento de erros e IPN

O Mercado Pago tem uma das APIs mais completas entre os gateways brasileiros. A integração direta permite usar esse potencial por inteiro, sem as limitações de um plugin intermediário.

Conversar sobre o projeto
Cenários de uso

Quando a integração com
o Mercado Pago faz sentido

Split via Marketplace API

Marketplace com vendedores independentes

Você tem uma plataforma onde vendedores independentes vendem seus produtos. O Marketplace API do Mercado Pago divide automaticamente o valor recebido entre o marketplace e o vendedor — descontando taxas e comissões — sem transferência manual.

Checkout Transparente

E-commerce com checkout próprio

Você quer um checkout com identidade visual própria e todos os métodos de pagamento do Mercado Pago disponíveis para o cliente. A integração via Checkout API entrega isso sem depender do checkout hosted redirecionado.

Backend customizado

Sistema próprio com múltiplos métodos

Seu sistema precisa aceitar cartão, Pix e boleto com lógicas diferentes para cada um — aprovação imediata, expiração, confirmação assíncrona. A integração direta permite implementar esse controle de forma precisa.

App iOS e Android

Aplicativo mobile com pagamento nativo

Seu app precisa processar pagamentos sem abrir um browser externo. O backend da integração processa as cobranças de forma segura, sem expor o access token no cliente mobile.

Processo

Como o projeto funciona

Análise do ambiente

Entender a plataforma, linguagem do backend e se há necessidade de marketplace, split ou integração com outros sistemas.

Levantamento de requisitos

Quais métodos de pagamento, se há marketplace, parcelamento sem juros, webhook IPN e regras de negócio específicas.

Configuração do sandbox

Criação de usuários de teste no Mercado Pago e configuração do ambiente de desenvolvimento com credenciais de sandbox.

Desenvolvimento

Construção dos endpoints de cobrança, Pix, boleto, marketplace e IPN com SDK ou chamadas diretas à API, conforme o stack.

Testes de homologação

Simulação de todos os cenários com usuários e cartões de teste: aprovação, recusa, Pix, split entre vendedor e marketplace.

Publicação em produção

Migração para credenciais de produção, deploy e acompanhamento das primeiras transações reais para garantir que o fluxo está correto.

Plataformas e ambientes

Marketplace próprio

Marketplace API com split e onboarding OAuth dos vendedores

WooCommerce

Módulo customizado quando o plugin oficial não atende o fluxo

OpenCart

Módulo integrado à API com checkout transparente

Sistema próprio

Integração via SDK ou API direta no backend existente

Aplicativo mobile

Backend seguro intermediário sem exposição de access token

Checkout headless

Frontend desacoplado com tokenização via MercadoPago.js

Não viu sua plataforma? Fale sobre o projeto — o processo começa pelo entendimento do ambiente atual.

Perguntas frequentes

O que é o Mercado Pago e como funciona sua API?

O Mercado Pago é o gateway do grupo Mercado Livre. Sua API REST suporta cartão, Pix, boleto e parcelamento, com SDKs oficiais para múltiplas linguagens e autenticação via access token OAuth.

O Mercado Pago tem sandbox para testes?

Sim. O Mercado Pago oferece ambiente sandbox completo com usuários e cartões de teste para simular todos os cenários antes de publicar em produção.

É possível fazer checkout transparente?

Sim. O Checkout API (Checkout Transparente) do Mercado Pago tokeniza o cartão via MercadoPago.js no frontend e processa a cobrança no backend — sem redirecionamento.

O Mercado Pago suporta split para marketplaces?

Sim. O Marketplace API divide automaticamente o valor entre o marketplace e os vendedores conectados via OAuth. É necessário um fluxo de onboarding para que os vendedores autorizem a conexão.

A integração suporta Pix?

Sim. A API suporta Pix com QR Code dinâmico e copia-e-cola. A confirmação do pagamento chega via IPN (webhook).

É possível integrar com WooCommerce ou OpenCart?

Sim. Para WooCommerce há plugin oficial, mas para OpenCart e plataformas sem módulo a integração via API é a alternativa.

O Mercado Pago suporta parcelamento sem juros?

Sim. O parcelamento sem juros é absorvido pelo vendedor como taxa e configurado nas opções da conta. A integração reflete essas regras no checkout.

Quanto custa e quanto tempo leva?

Depende do escopo: plataforma, métodos, marketplace, split, webhook e integrações. O melhor caminho é conversar sobre o projeto.

Próximo passo

Precisa integrar o Mercado Pago
ao seu sistema?

O primeiro passo é entender o cenário — plataforma, se há marketplace, quais métodos de pagamento e qual o fluxo de negócio. Sem compromisso.

Solicitar orçamento Atendimento para todo o Brasil · Projetos remotos