Como Conectar e Configurar o Mercado Pago na sua Subconta na Pulsefy

Por que conectar o Mercado Pago na sua Subconta?

Integrar o Mercado Pago diretamente na subconta permite que seu negócio aceite pagamentos em moeda local (BRL) via PIX, Cartão de Crédito (com parcelamento) e Boleto diretamente em funis de vendas, e-commerces, faturas, formulários e links de pagamento.

Etapa 1: Gerar as Credenciais no Mercado Pago

1. Acesse o painel de desenvolvedores do Mercado Pago ( mercadopago.com/developers) e faça login com a conta de vendedor da empresa.
2. Acesse Suas integrações e clique no botão Criar aplicação.

   

3. Preencha o formulário inicial da aplicação:
   • Nome do aplicativo: digite o nome da subconta ou negócio (ex: Pulsefy - Vendas).
   • Tipo de solução: escolha Pagamentos online.
   • Modelo: marque Desenvolvimento próprio e selecione Checkout Pro ou Checkout API.

   

   

4. Após criar a aplicação, vá no menu lateral esquerdo e acesse as abas de credenciais:
   • Credenciais de Produção: preencha a categoria do negócio e o domínio para liberar a Chave Pública (Public Key) e o Token de Acesso (Access Token) para cobranças reais.
   • Credenciais de Teste: copie a Test Public Key e o Test Access Token para testes simulados sem cobrança.

   

Etapa 2: Conectar o Mercado Pago no Painel da Subconta

1. Abra o painel da subconta desejada na Pulsefy.
2. No menu lateral esquerdo, vá para Pagamentos > Integrações.

   

3. Localize o cartão do Mercado Pago na lista e clique em Conectar.
4. Preencha as chaves da sua conta:
   • Insira a Public Key e o Access Token de Produção.
   • Se desejar realizar testes prévios, preencha também a Chave Pública de Teste e o Token de Acesso de Teste.

   

5. Selecione o país (Brasil) e clique em Salvar / Conectar.

   

Etapa 3: Definir o Mercado Pago como Gateway Padrão

1. Permaneça em Pagamentos > Integrações na subconta.
2. Ao lado da caixa do Mercado Pago, clique no botão Gerenciar (Manage).
3. Marque a opção Set as Default (Definir como Padrão).
4. Acesse a aba Configurar Provedores (Configure Providers). Aqui você pode definir regras por tipo de elemento visual:
   • Checkout de 1 Etapa (1-Step Checkout): defina o Mercado Pago como provedor.
   • Checkout de 2 Etapas (2-Step Checkout): defina o Mercado Pago como provedor.
   • Faturas (Invoices), Links de Pagamento e Formulários: confirme se o Mercado Pago está ativo.

   

Como Usar o Mercado Pago nas Vendas da Subconta

1. Vinculando Produtos a um Funil de Vendas

1. Na subconta, vá em Pagamentos > Produtos e crie o produto com o valor e a frequência desejada (pagamento único ou recorrência).
2. Vá em Sites > Funis (ou Sites).
3. Acesse a página onde está o seu checkout e vá na aba Produtos.
4. Clique em + Adicionar Produto, selecione o produto criado e salve.
5. Ao acessar a página, o comprador poderá pagar via PIX, Boleto ou Cartão de Crédito.

2. Gestão de Faturas e Cobranças Avulsas

1. Em Pagamentos > Faturas (Invoices), você pode criar faturas avulsas ou recorrentes para seus clientes.
2. Ao enviar a fatura para o e-mail ou WhatsApp do cliente, o link direcionará para a tela de pagamento do Mercado Pago.

3. Acompanhamento de Vendas e Assinaturas

• Transações: em Pagamentos > Pedidos/Transações, acompanhe em tempo real o status de cada cobrança (Aprovado, Pendente no PIX, Recusado).
• Assinaturas Ativas: em Pagamentos > Subscrições, visualize e gerencie todos os planos recorrentes ativos dos seus clientes.

Agente Autônomo: Confirmando Pagamento via PIX antes de Avançar o Funil

Se você estiver desenhando um agente autônomo que fecha pedidos, é preciso garantir que ele vá além de gerar o pagamento: ele precisa confirmar o pagamento antes de avançar a etapa do funil na conversão.

O Pulsefy não sabe se o PIX foi pago sozinho, porque o PIX é criado diretamente na API do Mercado Pago (não passa pelo módulo de pagamentos do GHL). Quem avisa é o próprio Mercado Pago, via webhook.

1. Configurar o Webhook no Painel do Mercado Pago

Esse passo leva cerca de 2 minutos e é obrigatório: sem ele, o Mercado Pago nunca avisa o receptor e o card nunca se move no funil.

1. No painel do Mercado Pago, acesse Suas integrações e abra a aplicação criada para a Pulsefy.
2. No menu lateral, vá em Notificações > Webhooks e clique em Configurar notificações.

   

3. Cadastre a URL do seu receptor no campo URL para teste (ou URL de produção, conforme o ambiente). Exemplo: https://n8n.seudominio.com.br/webhook/workspace-mp-pix.
4. No grupo Eventos recomendados para integrações com Checkout Pro, marque a opção Pagamentos (legacy).

   

5. Clique em Salvar configurações.

2. Construir a Automação "Pulsefy SDR - Pix Pago"

Depois que o webhook está ativo, a confirmação do pagamento dispara a automação dentro do Pulsefy:

1. Na subconta, crie uma automação chamada Pulsefy SDR - Pix Pago.
2. Defina o gatilho como Tag adicionada e escolha a tag pix-pago.
3. Adicione a ação Mover oportunidade e escolha a fase desejada do pipeline, por exemplo: "Pedido Feito IA 💰".

Dúvidas Frequentes na Subconta (FAQ)

Onde chegam os comprovantes de pagamentos feitos via PIX na subconta?

Quando o lead gera um PIX no checkout da subconta, o Mercado Pago envia o e-mail automático com a chave copia-e-cola. Assim que a transferência é concluída, a subconta altera o status do pedido para Pago em tempo real e ativa suas automações.

Posso usar contas de teste para verificar se o funil está funcionando?

Sim. Alterne o seletor da integração na subconta de Live para Test. O sistema usará as credenciais de teste para simular aprovações e recusar cartões sem movimentar dinheiro real.

O agendamento pago no Calendário já cobra pelo Mercado Pago?

A cobrança acoplada diretamente no momento de seleção de horário do calendário ainda passa por atualizações. O fluxo mais recomendado na subconta é direcionar o cliente para uma página com o checkout do Mercado Pago antes ou logo após ele agendar o horário.

Erro "Collector user without key enabled for QR render" ao gerar PIX

Esse erro significa que a conta do Mercado Pago ainda não tem uma chave Pix cadastrada para receber pagamentos — por isso o MP recusa a geração do QR Code, mesmo que o Access Token de produção esteja correto.

Para resolver, a empresa precisa cadastrar uma chave Pix na conta do Mercado Pago (app ou site):

1. Acesse Seu negócio → Pix → Suas chaves.
2. Cadastre uma chave Pix usando CPF/CNPJ, e-mail, telefone ou chave aleatória.
3. Aguarde a ativação e teste a geração do PIX novamente no funil.