Conectar o Mercado Pago
Receba com cartão parcelado e PIX pela sua conta Mercado Pago, em sete países da América Latina.
O Mercado Pago processa cartão de crédito, cartão de débito e PIX para contas abertas na Argentina, no Brasil, no Chile, na Colômbia, no México, no Peru e no Uruguai. Conectado ao Vipter, ele atende vendas avulsas, parcelamento no cartão e order bump.
Sem assinaturas e sem upsell de 1 clique
Assinaturas e upsell de 1 clique cobram o cartão salvo sem o comprador presente, e a conexão com o Mercado Pago não faz esse tipo de cobrança. Se você vende assinaturas, conecte também outro provedor de cartão, como a Pagar.me ou o Asaas, e mande as cobranças recorrentes para ele nos fluxos de pagamento.
Antes de começar
- Uma conta Mercado Pago e uma aplicação criada em Suas integrações, no portal Mercado Pago Developers. As chaves ficam dentro da aplicação.
- Papel Admin ou Dono no projeto do Vipter.
- Espaço no seu plano para mais uma conexão ativa. A tela de provedores mostra quantas você já usa.
Passo 1: copiar as credenciais no Mercado Pago
O Vipter aceita duas formas de autenticação: o Access Token com a Public Key, ou o Client ID com o Client Secret da aplicação. Se não souber qual usar, escolha o Access Token.
- No Mercado Pago Developers, abra Suas integrações e entre na sua aplicação.
- Abra ProduçãoCredenciais de produção para vender, ou TestesCredenciais de teste para experimentar.
- Copie o Access Token e a Public Key.
Guarde as credenciais com cuidado
O Access Token e o Client Secret permitem gerar cobranças na sua conta. Cole esses valores só no Vipter. Se vazarem, renove as credenciais no Mercado Pago e troque no Vipter pelo botão Trocar chaves.
Passo 2: criar a conexão no Vipter
- No painel do Vipter, abra PagamentosProvedoresMercado Pago.
- Clique em Nova conexão. Se a loja ainda não tem nenhuma conta Mercado Pago, o formulário já aparece aberto.
- Em Forma de autenticação, escolha Token do painel ou OAuth (aplicação), a mesma forma do passo 1.
- Preencha os campos numerados:
| # | Campo | O que colar |
|---|---|---|
| 1 | Nome da conta | Um nome para reconhecer a conta, como "Mercado Pago Brasil". Ele aparece nos fluxos de pagamento. |
| 2 | País da conta | O país onde a conta Mercado Pago foi aberta. Não dá para mudar depois. |
| 3 | Access Token | O Access Token que você copiou no passo 1. |
| 4 | Public Key | A Public Key das mesmas credenciais (de teste ou de produção) do Access Token. |
| 5 | Conexão de teste | Ligado, para usar as credenciais de teste. Desligue para cobrar de verdade com as credenciais de produção. |
- Clique em Salvar e obter a URL de webhook. O Vipter confere as credenciais com o Mercado Pago antes de salvar. Se estiverem erradas, nada é gravado e o erro aparece no formulário.
O modo de teste vem ligado
O botão Conexão de teste começa ligado para que a primeira conexão não cobre ninguém por engano. Para vender, crie a conexão com ele desligado e as credenciais de produção.
Se a loja ainda não tem fluxo para cartão de crédito, cartão de débito ou PIX, o Vipter cria esses fluxos apontando para a nova conta. A loja já pode cobrar depois do passo 4.
Passo 3: configurar as notificações no Mercado Pago
Pelo webhook, o Mercado Pago avisa o Vipter do que acontece com cada pagamento: PIX pago, pagamento aprovado depois de análise, reembolsos e chargebacks. Cada aviso vem assinado com uma assinatura secreta que o Mercado Pago gera para a sua aplicação.
- Depois de salvar, o card da conexão mostra a URL do webhook. Copie o endereço.
- No Mercado Pago Developers, abra Suas integrações, entre na mesma aplicação do passo 1 e vá em WebhooksConfigurar notificações.
- Escolha a aba do ambiente da conexão: a de teste, para uma conexão de teste, ou Modo produtivo, para vender.
- Cole a URL copiada no item 1.
- Em eventos, selecione Pagamentos. É o único evento que o Vipter usa.
- Salve. O Mercado Pago gera a assinatura secreta da aplicação. Revele e copie o valor.
- Volte ao Vipter, cole a assinatura no card da conexão e clique em Salvar segredo.
| # | Campo | O que colar |
|---|---|---|
| 1 | Segredo do webhook (assinatura secreta) | A assinatura secreta que o Mercado Pago gerou no item 6, copiada exatamente como aparece. |
Se você renovar a assinatura
O Mercado Pago permite renovar a assinatura secreta. Depois de renovar, cole o novo valor no Vipter e clique em Salvar segredo de novo. Enquanto os dois valores forem diferentes, os avisos são recusados.
Passo 4: testar a conexão
- No card da conexão, clique em Testar. O Vipter consulta o Mercado Pago com as credenciais salvas.
- Faça uma compra de teste no checkout de uma oferta. Com credenciais de teste de uma conta do Brasil, use o cartão Visa
4235 6477 2802 5682, validade11/30e CVV123. No nome do titular, escrevaAPROpara o pagamento ser aprovado, e use o CPF123.456.789-09.
Deu certo se
Aparece a mensagem Conexão OK., o card mostra Segredo de verificação configurado. e a compra de teste entra em VendasTransações como paga.
Problemas comuns
-
Seu plano permite N conector(es) ativo(s). Faça upgrade para adicionar mais.
O plano chegou ao limite de conexões ativas. Desative uma conexão que não usa mais ou mude de plano em Plano Vipter.
-
Selecione um país atendido por este provedor.
O Mercado Pago só é aceito nos sete países da lista. Escolha o país em que a conta foi aberta.
-
O Mercado Pago recusou as credenciais
As credenciais são de outra aplicação, estão incompletas ou não combinam com o país escolhido. Confira também se o Access Token e a Public Key vieram do mesmo ambiente (teste ou produção) e se a forma de autenticação escolhida no Vipter é a mesma das credenciais.
-
Sem o segredo de verificação a plataforma recusa os eventos deste provedor. Cadastre a URL acima no provedor, copie o segredo e salve aqui.
A assinatura secreta não foi salva no Vipter. Refaça o passo 3.
O que fazer a seguir
- Defina quantas parcelas a loja oferece e com quais juros em parcelamento.
- Revise os fluxos de pagamento para decidir qual conta cobra cada pagamento e qual serve de reserva.