Configuração da Loja

Conectar o Mercado Pago

Atualizado em 03/11/2026

O Mercado Pago aceita PIX, boleto e cartão no checkout transparente da loja. A conexão é feita com as credenciais da sua conta — não há login nem autorização por OAuth.

Para que serve

Conectar o Mercado Pago deixa a sua loja cobrar PIX, boleto e cartão de crédito dentro do próprio checkout, sem mandar o cliente para outro site. O dinheiro cai na sua conta Mercado Pago, e a Horsee confirma o pedido sozinha quando o pagamento é aprovado.

Passo a passo

  1. No painel do Mercado Pago, abra Suas integrações → Credenciais e use as Credenciais de produção.
  2. Copie o Access Token (começa com APP_USR-) e a Public Key.
  3. Na Horsee, abra Configurar → Apps → Pagamentos → Mercado Pago → Configurar. A janela se chama Conectar Mercado Pago.
  4. Em Credenciais (BYO), cole o Access Token e a Public Key.
  5. Desligue o Modo teste se for vender de verdade. Ele vem ligado numa conexão nova.
  6. Copie a URL do Webhook mostrada na janela e cole no Mercado Pago, em Suas integrações → Webhooks.
  7. O Mercado Pago gera uma assinatura secreta. Copie e cole no campo Webhook Secret da Horsee.
  8. Clique em Salvar e depois em Testar Conexão. O status passa a Conta conectada.
  9. Em Configurações → Meios de Pagamento, escolha o Mercado Pago como gateway de PIX, boleto e/ou cartão.

Opções do Mercado Pago no checkout

Com o Mercado Pago escolhido em Meios de Pagamento, aparecem campos próprios: parcelamento (máximo de parcelas, sem juros até e parcela mínima), expiração do PIX em minutos, expiração do boleto em dias e o nome que aparece na fatura do cartão, com até 22 caracteres.

Modo de teste

Para testar sem cobrar ninguém, use as credenciais de teste (Access Token e Public Key que começam com TEST-) de um usuário de teste do Mercado Pago e deixe o Modo teste ligado. Troque pelas de produção e desligue o Modo teste antes de vender.

Erros comuns

  • "Modo teste ativo" com a loja no ar: os pagamentos não são cobrados de verdade. Desligue o Modo teste e salve.
  • Pedido pago que continua pendente: o webhook não foi cadastrado ou o Webhook Secret está errado. Refaça os passos 6 e 7.
  • Loja em outra moeda: o Mercado Pago opera apenas em BRL (Real). Para vender em outra moeda, use um gateway internacional.
  • Mercado Pago não aparece no checkout: confira se ele foi escolhido para o método em Meios de Pagamento.
Dica: O Access Token fica guardado cifrado e não é exibido de novo depois de salvo. A Public Key é pública por natureza (o checkout usa no navegador).

Este artigo foi útil?

Ajude-nos a melhorar nosso conteúdo com seu feedback