Conectar o Mercado Pago

O que é a integração

Ao conectar o Mercado Pago na CopyFunnel, seu checkout passa a oferecer Pix, cartão de crédito e boleto pelo maior PSP da América Latina. O dado cru do cartão é tokenizado no próprio navegador (SDK do Mercado Pago) — nunca passa pelo servidor da CopyFunnel — e a confirmação das vendas é reconfirmada direto na API do MP, além de dar suporte a Apple Pay e Google Pay (carteiras digitais). O Mercado Pago foi o primeiro gateway a processar uma venda real na plataforma, via Pix.

Onde pegar as credenciais

O Mercado Pago usa duas credenciais:

1. Public Key — chave pública usada para tokenizar o cartão no navegador do comprador.
2. Access Token — chave privada usada pelo servidor para criar e consultar cobranças.

Para pegar as duas:

1. Acesse o painel de desenvolvedores do Mercado Pago (mercadopago.com.br/developers).
2. Faça login com a sua conta Mercado Pago (a mesma que recebe o dinheiro).
3. No painel, procure por Suas aplicações (ou "Minhas aplicações") e abra a aplicação que você usa — ou crie uma nova.
4. Em Credenciais de produção, copie a Public Key e o Access Token de produção.

Importante: se você copiar credenciais de teste, o checkout só funcionará em modo de teste. Use as de produção para vender de verdade (ou marque a opção de sandbox na CopyFunnel, veja abaixo).

Conectar na CopyFunnel

1. No painel da CopyFunnel, entre em Integrações.
2. Clique no card do Mercado Pago (os cards mostram o status: Não configurado, Configurado ou Conectado).
3. No drawer que abre, preencha:
   • Public Key (placeholder: "Public Key") — campo visível, obrigatório.
   • Access Token (placeholder: "Access Token") — campo de senha, cifrado na CopyFunnel e nunca exibido de novo (só os 4 últimos dígitos).
4. Se estiver usando credenciais de teste, marque Usar sandbox (credenciais de teste) — desmarque para produção.
5. Clique em Testar conexão. O teste faz uma leitura real e barata na API do MP (listagem de pagamentos, limite 1) — se o Access Token estiver válido, aparece "Conexão realizada com sucesso."
6. Clique em Salvar. Ao salvar, a conexão é testada de novo: com sucesso você vê "Credenciais salvas e conexão verificada." e o card passa a Conectado.

Só a credencial Conectado entra no checkout. Se o teste falhar ao salvar, a credencial fica Configurado (salva, mas ainda não ativa no checkout) — corrija e teste de novo.

O que acontece depois

Com a conexão validada, o checkout passa a exibir os métodos cobertos: Pix (QR Code + copia e cola, gerado na hora), cartão de crédito (tokenizado no navegador, com parcelamento) e boleto (compensa em 1–3 dias úteis), além de carteiras (Apple Pay/Google Pay). Cada método exige que a Public Key esteja salva para tokenizar o cartão no navegador.

A confirmação de Pix/boleto usa webhook do Mercado Pago validado por assinatura HMAC — e nenhuma notificação aprova a venda sozinha: a CopyFunnel sempre reconfirma o status direto na API do MP. Se a notificação atrasar, há confirmação automática por polling (botão "Conferir pgto." na página do pedido + cron de reconciliação).

Para finalizar, faça uma compra de teste de R$ 1,00 com um produto real do seu funil e confira se ela aparece em Vendas no painel, com o status correto.

Dicas de erro comuns

• "Informe Public Key." — o campo visível ficou vazio ao salvar. Os dois campos são obrigatórios.
• "Informe Access Token para conectar." — o segredo ficou vazio. (Deixar o campo de senha vazio em um novo save preserva o token já salvo; em credencial nova, não há o que preservar.)
• "Falha na autenticação. Verifique as credenciais." — o Access Token foi rejeitado pela API do MP. Confira se você copiou o token de produção completo (sem espaços) e se ele pertence à conta que recebe o dinheiro.
• Card não mostra botão de cartão — confira se a Public Key foi salva; sem ela a CopyFunnel não consegue tokenizar o cartão no navegador.
• Erro de token do cartão na compra — token de cartão expira rápido; é gerado a cada tentativa do comprador, então normalmente basta o comprador tentar de novo.