Como conectar o Mercado Pago

Conecte a sua conta do Mercado Pago para receber por Pix e cartão de crédito dentro da loja, com confirmação automática.

No painel:ConfiguraçõesPagamentos Só o administrador da lojaAtualizado em 16 de outubro de 2026

Já tem loja na UnaShop? Abra esta tela no seu painel e siga junto.

Abrir no painel

Neste tutorial você conecta a conta do Mercado Pago da sua loja e passa a receber por Pix e cartão de crédito sem o cliente sair do site (o chamado checkout transparente). O dinheiro cai direto na sua conta do Mercado Pago. A tela de Pagamentos é do administrador da loja, ou de um usuário com a permissão de pagamentos.

Antes de começar

  • Tenha uma conta no Mercado Pago em nome da loja e consiga entrar com ela no Mercado Pago Developers.
  • Separe uns 15 minutos: você vai copiar dados no Mercado Pago e colar no painel da UnaShop.
  • Se quiser testar antes, comece pelas credenciais de teste. Depois é só trocar pelas de produção.

Passo a passo

  1. 1

    Abra a tela de Pagamentos

    No menu lateral, clique em Configurações e depois em Pagamentos. Em loja nova, o topo avisa Sua loja ainda não recebe pagamentos.

  2. 2

    Abra o painel do Mercado Pago

    Na seção Escolha como receber, clique no cartão do Mercado Pago. O painel lateral abre na etapa Conectar. Se preferir, use o botão Conectar Mercado Pago do aviso do topo.

  3. 3

    Crie a aplicação no Mercado Pago

    Abra o bloco Onde encontro? e clique em Abrir o Mercado Pago Developers. Entre com a conta da loja e, em Suas integrações, crie uma aplicação (ou abra a que você já tem).

  4. 4

    Copie as credenciais

    Na aplicação, em Credenciais, copie a Public Key e o Access Token. As de teste começam com TEST e as de produção começam com APP_USR.

  5. 5

    Escolha o modo

    No painel da UnaShop, deixe a chave Modo de produção desligada se for colar credenciais de teste, ou ligada se forem as de produção. O modo precisa combinar com as credenciais.

  6. 6

    Cole a Public Key e o Access Token

    Cole cada valor no campo com o mesmo nome. O Access Token é secreto: depois de salvo ele não aparece mais, e o campo mostra que já está configurado.

  7. 7

    Cadastre o webhook no Mercado Pago

    No bloco Webhook (IPN), clique em Copiar ao lado de URL do webhook. No Mercado Pago, na área de Webhooks da sua aplicação, cadastre essa URL para as notificações de pagamentos. Cole exatamente como copiou: o endereço já leva a identificação da sua loja.

  8. 8

    Cole a assinatura secreta

    Ainda em Webhooks, no Mercado Pago, copie a Assinatura secreta e cole no campo Assinatura secreta (webhook) da UnaShop.

  9. 9

    Salve

    Clique em Conectar Mercado Pago. Com tudo certo, aparece a mensagem de configurações salvas e o painel avança para Verificar.

  10. 10

    Confira a verificação

    Veja se aparecem Conta conectada, Webhook com assinatura configurada e o modo escolhido. Se aparecer Falta a assinatura do webhook, clique em Configurar agora e repita o passo anterior.

  11. 11

    Ative o Mercado Pago

    Clique em Continuar para ativar e depois em Usar Mercado Pago para receber. Quando aparecer a confirmação de que a loja já recebe com o Mercado Pago, clique em Concluir.

O que cada campo faz

  • Modo de produção: ligado, os pagamentos são reais. Desligado, a loja usa credenciais de teste e nada é cobrado.
  • Public Key: chave pública que o checkout usa no navegador para ler o cartão com segurança.
  • Access Token: chave secreta que o servidor usa para criar as cobranças. Para trocar, cole uma nova; para manter, deixe em branco.
  • URL do webhook: endereço que o Mercado Pago chama quando um pagamento muda (aprovado, recusado, estornado).
  • Assinatura secreta (webhook): prova que o aviso veio mesmo do Mercado Pago. Sem ela, o Pix não é confirmado sozinho e o pedido fica pendente.

Como fica na loja

Com o Mercado Pago ativo, o checkout mostra Cartão de crédito e Pix. No cartão, o cliente digita os dados ali mesmo e escolhe as parcelas. No Pix, ele recebe o QR Code e o código copia e cola ao finalizar. Quando o pagamento é aprovado, o pedido passa para pago sozinho e o estoque é baixado.

Depois de conectar, veja como testar pagamentos antes de vender e, se quiser, como dar desconto no Pix.

Dúvidas comuns

O dinheiro cai na conta da UnaShop?

Não. O pagamento cai na sua conta do Mercado Pago, com as taxas do Mercado Pago. A UnaShop só guarda as credenciais da sua loja, no servidor.

Como passo do teste para a produção?

Cole as credenciais de produção, ligue Modo de produção e salve. O passo a passo está em como passar o Mercado Pago para produção.

Por que o painel insiste na assinatura secreta?

É ela que permite confirmar o Pix sozinho. Sem a assinatura, o aviso do Mercado Pago é recusado e o pedido fica como pendente até alguém conferir.

Posso deixar o Mercado Pago conectado e usar outro gateway?

Sim. Só o gateway ativo cobra no checkout. O Mercado Pago continua conectado, pronto para você ativar de novo quando quiser.

Veja também

Ainda precisa de ajuda?

    Como conectar o Mercado Pago | Ajuda UnaShop