Integrar o Mercado Pago no Shopify consiste em três etapas centrais: instalar o app oficial pelo painel administrativo da Shopify, vincular a conta do Mercado Pago e ativar os meios de pagamento desejados. O processo pode ser concluído em poucos minutos, mas exige atenção a detalhes como o tipo de credencial usada e a escolha entre os dois modelos de checkout disponíveis.
Ao longo deste artigo, você vai encontrar o passo a passo atualizado de instalação e vinculação, a diferença prática entre o Checkout Pro e o Checkout Transparente, orientações sobre como configurar parcelas e taxas após a ativação, e soluções para os erros mais relatados por quem administra lojas Shopify.
O que você precisa antes de integrar o Mercado Pago no Shopify
Antes de começar a instalação, vale conferir se tudo está em ordem do lado da sua conta e da sua loja. Com os itens certos prontos, o processo segue sem interrupções.
Os pré-requisitos para a integração são:
- Conta ativa no Mercado Pago com dados pessoais e verificação de identidade concluídos
- Loja Shopify configurada e com certificado SSL ativo (obrigatório para processar pagamentos)
- Acesso ao painel administrativo da Shopify com permissões de edição em Configurações > Pagamentos
- Nenhum conhecimento técnico avançado é exigido — todo o processo acontece por interface visual, sem código
Com esses pontos verificados, a instalação do app pode ter início sem complicações.
Checkout Pro ou Checkout Transparente: qual escolher na Shopify
O Mercado Pago oferece dois tipos de checkout para lojas Shopify, e cada um atende a necessidades diferentes. Entender as diferenças ajuda a escolher a opção que faz mais sentido para o perfil da loja.
Como funciona o Checkout Pro na Shopify
No Checkout Pro, quem compra é redirecionado ao ambiente seguro do Mercado Pago para concluir o pagamento. Nesse ambiente, a pessoa pode usar meios de pagamento já salvos na conta — cartão de crédito, débito, Pix, boleto, Linha de Crédito e até o saldo da conta Mercado Pago. Após o pagamento, o retorno à loja acontece de forma automática.
Esse modelo é uma boa opção quando a prioridade é oferecer o maior número de meios de pagamento possível. Quem já tem conta no Mercado Pago encontra o processo ainda mais ágil, pois os dados ficam salvos.
Como funciona o Checkout Transparente na Shopify
O Checkout Transparente (disponível pelo app Mercado Pago Cartões) mantém quem compra dentro da própria loja durante todo o processo. O pagamento é feito sem redirecionamento, com suporte a cartão de crédito, débito, Pix e boleto.
Essa opção preserva a identidade visual da loja e pode contribuir para uma experiência mais coesa. Vale destacar que os dois apps podem ser instalados ao mesmo tempo, ampliando as opções de pagamento sem que um exclua o outro.
Passo a passo para integrar o Mercado Pago no Shopify
O processo de integração segue três etapas principais: instalação do app, vinculação da conta e ativação dos pagamentos. Cada uma delas é feita pelo painel administrativo da Shopify.
Como instalar o app do Mercado Pago na Shopify
O caminho para instalar o app começa nas configurações da loja. Siga os passos abaixo:
- Acesse o painel administrativo da sua loja Shopify
- Clique em Configurações, no canto inferior esquerdo
- No menu, selecione Pagamentos
- Em “Formas de pagamento aceitas”, clique em Adicionar forma de pagamento
- Na aba Buscar por provedor, digite o nome do app desejado:
– Mercado Pago Checkout Pro para o checkout com redirecionamento
– Mercado Pago Cartões para o checkout dentro da loja - Selecione o app encontrado e clique em Instalar
- Leia as permissões solicitadas e clique em Instalar novamente para confirmar
Para ativar os dois modelos ao mesmo tempo, repita o processo para cada app separadamente.
Como vincular a conta do Mercado Pago à loja
Após a instalação, o próximo passo é conectar a conta do Mercado Pago à loja. Veja como fazer:
- Dentro do app instalado, clique em Gerenciar conta
- Selecione Iniciar vinculação
- Escolha se a conta a ser vinculada é a sua própria ou de terceiros
- Clique em Vincular conta e aceite as permissões solicitadas
- Ao concluir, clique em Ativar app
Um detalhe importante: a vinculação feita em um app do Mercado Pago vale para todos os demais apps da mesma marca instalados na mesma loja. Não é necessário repetir esse processo para cada app individualmente.
Como ativar os meios de pagamento
Com a conta vinculada, a ativação dos meios de pagamento é o passo final:
- Vá em Configurações > Pagamentos no painel da Shopify
- Localize o provedor instalado (Checkout Pro ou Mercado Pago Cartões)
- Clique em Ativar para que o meio de pagamento fique disponível no checkout da loja
- Repita para cada app instalado, caso tenha optado pelos dois
Após a ativação, os meios de pagamento já aparecem para quem acessa o checkout da loja.
Como configurar parcelas e taxas após a integração
Com o app ativo, é possível ajustar as condições de parcelamento e as taxas aplicadas às vendas. Esse passo fica disponível pelo Painel Administrativo do Mercado Pago para Shopify, acessado pelo caminho: Configurações > Pagamentos > Gerenciar (no provedor Mercado Pago Cartões) > Configuração de parcelas e taxas.
Nesse painel, é possível definir o número máximo de parcelas sem acréscimo, as taxas aplicadas por número de parcelas e o prazo de recebimento das vendas. As configurações feitas ali se aplicam a todas as lojas Shopify vinculadas à mesma conta do Mercado Pago — o que facilita a gestão para quem administra mais de uma loja.
Oferecer parcelamento sem acréscimo costuma influenciar a decisão de compra, sobretudo em produtos de ticket mais alto. Vale avaliar essa configuração com base no perfil dos produtos vendidos e na margem disponível.
Erros comuns na integração do Mercado Pago com Shopify e como resolver
Mesmo seguindo o passo a passo, alguns erros podem surgir durante ou após a configuração. Estes são os problemas mais relatados por lojistas e as formas de contorná-los.
Falha de Public Key e Access Token
Esse erro costuma aparecer quando as credenciais foram copiadas do ambiente de teste em vez do ambiente de produção. Outro motivo frequente são espaços em branco inseridos sem querer ao copiar e colar as chaves.
Para resolver, acesse o painel de desenvolvedores do Mercado Pago, confirme que está no modo de produção e copie as credenciais com atenção. Cole os valores em um editor de texto simples antes de inserir no campo, para garantir que não há caracteres extras.
Erro no checkout ao processar pagamento
Quando o erro aparece no momento do pagamento, as causas mais comuns são: cartão sem saldo ou limite disponível, dados do cartão digitados com erro, ou falha de comunicação entre os sistemas. O primeiro passo é testar com outro cartão para identificar se o problema está no meio de pagamento ou na configuração.
Também vale verificar se o certificado SSL da loja está ativo. Sem SSL, as transações não são processadas e o checkout pode apresentar falhas. Essa informação fica disponível nas configurações da loja na Shopify.
Conflito entre apps antigos e novos do Mercado Pago
O Mercado Pago atualizou seus apps para Shopify ao longo do tempo, e manter o app antigo instalado junto com o novo pode gerar conflitos no checkout. Se a loja passou por uma migração recente ou se o app foi reinstalado, é recomendável desinstalar o app anterior antes de configurar o novo.
Para isso, vá em Configurações > Pagamentos na Shopify, localize o app antigo e remova-o antes de iniciar a instalação da versão atual. Caso o problema persista após essas verificações, o suporte do Mercado Pago pode ser acionado pelo canal oficial de atendimento.
Perguntas frequentes sobre a integração do Mercado Pago no Shopify
É possível usar o Checkout Pro e o Checkout Transparente ao mesmo tempo na Shopify?
Sim. Os dois apps podem ser instalados e ativados na mesma loja sem conflito. Dessa forma, quem compra tem acesso a um leque maior de meios de pagamento, podendo escolher entre o ambiente redirecionado do Mercado Pago ou o checkout dentro da própria loja.
Preciso de conhecimento técnico para integrar o Mercado Pago no Shopify?
Não é necessário saber programar. Todo o processo acontece pelo painel administrativo da Shopify, com cliques e preenchimento de campos. Nenhuma linha de código é exigida para a instalação padrão dos apps.
Quais meios de pagamento ficam disponíveis após a integração?
Depende do app instalado. O Checkout Pro aceita cartão de crédito, débito, Pix, boleto, Linha de Crédito e saldo da conta Mercado Pago. O Checkout Transparente (Mercado Pago Cartões) aceita cartão de crédito, débito, Pix e boleto. Com os dois apps ativos, a loja reúne todas essas opções.
O que fazer se a vinculação da conta do Mercado Pago não funcionar?
Vale verificar três pontos: se a conta do Mercado Pago está com dados e verificação em dia, se o navegador está configurado para permitir pop-ups (a janela de vinculação abre em pop-up) e se não há um app antigo do Mercado Pago instalado causando conflito com o novo.