Pular para o conteúdo
LojaVirtual.com.br Central de ajuda

Como configurar Mercado Pago para Pix e cartão

A integração Mercado Pago disponível no checkout aceita Pix e cartão de crédito. Boleto não faz parte desta configuração.

Configure a conta

  1. Abra Formas de pagamento > Mercado Pago.
  2. Em Chaves de acesso, informe a Public Key e o Access Token correspondentes à conta e ao ambiente que utilizará. Se já houver chaves cadastradas, use Substituir chaves.
  3. Habilite Pix e/ou cartão e revise as condições de parcelamento disponíveis.
  4. Confira a Disponibilidade, revise as regras de exibição em Configurações avançadas e clique em Salvar alterações.

Onde encontrar a Public Key e o Access Token

  1. Entre no Mercado Pago Developers com a conta que vai receber as vendas e abra Suas integrações.
  2. Crie uma aplicação, se ainda não tiver, ou clique na aplicação existente.
  3. No menu lateral, abra Credenciais de produção. Na primeira vez, o Mercado Pago pede o ramo do negócio, o site da loja e o aceite dos termos para ativar essas credenciais.
  4. Copie a Public Key e o Access Token de produção, que começam com APP_USR-, e cole nos campos de mesmo nome na LojaVirtual. Credenciais que começam com TEST- são de teste e não recebem dinheiro real.
  5. Em Disponibilidade, ligue Ativo na loja e clique em Salvar alterações. A LojaVirtual confere o Access Token com o Mercado Pago antes de ativar.

O mesmo passo a passo está em Como configurar?, na lista de Formas de pagamento e no topo da configuração do Mercado Pago. Veja a documentação de credenciais do Mercado Pago.

As credenciais identificam a conta que recebe as cobranças. Não misture dados de teste e produção e não publique o Access Token. Se já existe configuração válida, revise-a antes de substituir credenciais.

Credencial configurada: consultar ou substituir as chaves

O cartão Chaves de acesso mostra uma representação mascarada das chaves salvas, em modo de consulta. A etiqueta Cadastradas indica que as duas chaves estão armazenadas; ela não confirma a conexão.

Clique em Substituir chaves para abrir os campos de edição. Eles começam vazios: deixe o campo vazio para manter o valor salvo e preencha somente a chave que deseja substituir. O Access Token é digitado em campo protegido e não é devolvido integralmente ao navegador após o armazenamento.

Cancelar substituição descarta somente as chaves digitadas, preservando as demais alterações da tela. Se houver erro ao salvar, os valores digitados permanecem disponíveis para correção. Se uma credencial não puder ser lida, contate o suporte antes de substituí-la.

Use Testar conexão para conferir o acesso com as chaves salvas.

Onde encontrar as chaves do Mercado Pago

O botão Onde encontrar as chaves? abre estas instruções na própria tela, com uma correspondência visual entre as chaves e os campos:

  1. Acesse Suas integrações no Mercado Pago (nova aba) com a conta que receberá as vendas. Selecione a aplicação da loja ou siga a criação orientada pelo provedor.
  2. Na aplicação, abra Produção e localize as credenciais. Conclua a ativação solicitada pelo Mercado Pago, quando necessária. Use produção para vendas reais.
  3. Copie Public Key para Public Key (chave pública) e Access Token para Access Token (chave secreta). Não misture contas ou ambientes.
  4. Salve a configuração e use Testar conexão. Não compartilhe o Access Token em mensagens ou capturas de tela.

Disponibilidade e alterações pendentes

Situação da conexão mostra o resultado da verificação; Disponibilidade controla a ativação na loja. Uma conta pode ter acesso verificado e continuar desativada pelo lojista.

Os interruptores de Pix, cartão e Ativo na loja são aplicados somente após salvar. A tela distingue a escolha atual da situação já salva. Desligar o cartão preserva o parcelamento, que fica desabilitado para edição até a modalidade ser ligada novamente.

O botão Salvar alterações permanece no cabeçalho. Quando ele sai da área visível e há alterações pendentes, aparece uma barra compacta de salvamento. Ao tentar sair com alterações, escolha Continuar editando ou Sair sem salvar. Ao fechar ou recarregar a aba, o navegador apresenta sua própria confirmação.

Em Configurações avançadas, revise valores mínimo e máximo, pessoa física/jurídica, mensagem ao cliente, prioridade, nome e exibição no checkout. Recolher essa seção não apaga seus valores.

Acompanhe o recebimento

O comprador recebe as instruções do Pix ou conclui os dados do cartão no checkout. Uma cobrança pendente ainda não é uma venda paga. Acompanhe a confirmação no pedido e consulte a conta do provedor quando precisar investigar uma divergência.

Se a opção não aparecer, revise modalidade ativa, credenciais e regras de valor ou tipo de pessoa. Se uma tentativa tiver resultado incerto, confira o pedido e a transação antes de gerar outra cobrança. A configuração não equivale à aprovação comercial da conta pelo Mercado Pago.

Teste as credenciais salvas

Depois de salvar, use Testar conexão no cartão Situação da conexão. O teste consulta a API sem criar pagamento e usa somente os dados já gravados; alterações ainda digitadas no formulário não são enviadas. Ao ativar um cadastro inativo, a plataforma também verifica o acesso antes de habilitá-lo. Credenciais recusadas exigem conferir as chaves e as permissões. Uma verificação não concluída, como falha temporária ou de sessão, não comprova que as chaves são inválidas. Renove a sessão quando indicado e tente novamente.

Esse teste não comprova a tokenização do cartão nem a liberação de todos os meios pela sua conta. O checkout respeita o limite de até 12 parcelas e o valor mínimo configurados; juros e condições são definidos pela sua conta e pelo cartão. Informar o máximo não ativa parcelamento sem juros.

O resultado Conexão verificada só aparece após resposta positiva do teste. Se o ambiente identificado for de testes, isso será informado. A confirmação usa as chaves salvas, mesmo quando houver novas chaves digitadas; salve antes de testar a substituição.

Cancelamento e estorno

Esta integração ainda não oferece o comando de estorno no detalhe do pedido. Solicite a operação no painel do provedor, quando disponível, e acompanhe a conciliação. Alterar o status comercial do pedido não devolve dinheiro automaticamente.

Veja também configuração de pagamentos e acompanhamento de pedidos.

Estorno ou contestação antes da confirmação

Quando a consulta ao provedor identifica um estorno ou uma contestação, a plataforma mantém o pagamento em conferência para a conclusão do pedido, mesmo que a aprovação ainda não tenha chegado. Uma aprovação antiga recebida depois não remove esse bloqueio.

Se o pedido já tiver sido concluído, seu histórico e sua baixa de estoque são preservados. Confira a transação e trate o pedido com o suporte antes de realizar outra cobrança ou alterar o estoque. Veja também como acompanhar os pedidos.

Mostrar o valor das parcelas na página do produto

Em Formas de pagamento > Mercado Pago > Parcelamento no cartão, preencha Parcelas sem juros com a quantidade que você conferiu no Mercado Pago. O máximo de um novo cadastro começa em 3 parcelas; ajuste-o se sua oferta for diferente. Por exemplo, se a conta oferece 6 vezes sem juros, informe 6 nos dois limites. O limite deve ser igual ou menor que o máximo de parcelas da loja.

Deixe vazio se ainda não confirmou essa condição; informe 0 se não oferece parcelas sem juros. Salvar aqui não habilita parcelamento nem altera taxas no Mercado Pago. A conferência é manual: ao mudar de conta ou alterar condições no provedor, atualize também este cadastro. O teste de credenciais não sincroniza taxas.

Após salvar, os temas que mostram parcelamento calculam o valor localmente, respeitando o preço da variação e a parcela mínima. Um produto de R$ 1.800,00 com 12 parcelas sem juros confirmadas aparece como 12x de R$ 150,00 sem juros. A página não consulta o Mercado Pago para fazer esse cálculo. Sem condição confirmada, informa apenas o limite e orienta a consultar os juros no pagamento.

Confira também como as condições aparecem no produto.

O exemplo de R$ 300,00 na configuração respeita a parcela mínima e distribui diferenças de centavos quando necessário. Ele é ilustrativo e depende das condições que você confirmou no provedor.

Conexão, disponibilidade e salvamento

A tela separa a situação da conexão da ativação escolhida para a loja. Use Salvar alterações após editar e confira a confirmação. Para entender as chaves protegidas, a substituição e os estados apresentados, veja como usar a configuração dos provedores.

Assista ao passo a passo