Já tem loja na UnaShop? Abra esta tela no seu painel e siga junto.
Abrir no painelNeste 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
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
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
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
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
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
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
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
Cole a assinatura secreta
Ainda em Webhooks, no Mercado Pago, copie a Assinatura secreta e cole no campo Assinatura secreta (webhook) da UnaShop.
- 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
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
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.
