Pular para o conteúdo
Acessar conta

Mercado Pago

Crie o link de pagamento do Mercado Pago no meio do fluxo e confira se o cliente pagou, com o Access Token e a requisição externa.

IntegraçãoPagamentosPela API
Atualizado em 25/10/2026

O Mercado Pago se liga à NexTags pela API. Num fluxo, a requisição externa cria um link de pagamento (Checkout Pro) para o contato e, depois, consulta se o pagamento foi aprovado. A NexTags não tem cartão do Mercado Pago em Configurações › Integrações: a chave fica num campo do bot. Os avisos (webhooks) do Mercado Pago trazem só o número do pagamento, sem o telefone nem o e-mail do cliente, por isso não acham o contato num webhook de entrada.

O que dá para fazer

Como conectar

Passo 1: Copie o Access Token de produção

No Mercado Pago, entre em Suas integrações e abra a sua aplicação, ou crie uma. Nas credenciais, escolha produção, ative o ambiente de produção se for a primeira vez e copie o Access Token. Guarde-o num campo do bot, como Token do Mercado Pago: veja Campos do bot: um valor para a conta toda. Mais detalhes na documentação do Mercado Pago.

Passo 2: Crie o link de pagamento no fluxo

Numa etapa Ações, adicione External API Request. Em Request Type, escolha POST e, em Request URL, cole https://api.mercadopago.com/checkout/preferences. Na aba Cabeçalhos, ponha Authorization com Bearer e o campo do token.

  1. Request Type: POST.
  2. Request URL: o endereço do Mercado Pago.
  3. As abas da janela: Cabeçalhos, Corpo, Mapeamento de resposta e Testar Agora.
  4. O cabeçalho: Authorization à esquerda e Bearer {{Token do Mercado Pago}} à direita.

Na aba Corpo, escolha JSON e descreva o que o cliente paga. O external_reference guarda o id do contato, para achar o pagamento depois:

{
  "items": [
    {
      "title": "Consultoria de 1 hora",
      "quantity": 1,
      "unit_price": 150.00,
      "currency_id": "BRL"
    }
  ],
  "external_reference": "{{user_id}}"
}

Passo 3: Guarde o link e mande ao contato

Na aba Mapeamento de resposta, guarde $.init_point, o link do checkout, num campo, como Link de pagamento. Confira em Testar Agora, clique em Salvar e mande o link numa mensagem ou num botão do fluxo. Ligue a saída Falhado a um aviso para a equipe.

  1. JSONPath: o caminho do dado na resposta, aqui $.init_point.
  2. Salvar em um campo personalizado: o campo que recebe o link.

Passo 4: Confira o pagamento

Quando o cliente disser que pagou, use outra External API Request, com GET, o mesmo cabeçalho e este endereço:

https://api.mercadopago.com/v1/payments/search?sort=date_created&criteria=desc&external_reference={{user_id}}

Guarde a situação do pagamento mais recente ($.results[0].status) num campo e use uma condição: approved é aprovado; pending e in_process ainda estão em andamento; rejected foi recusado.

  1. Código do estado: 200 é sucesso.
  2. Corpo da resposta: confira aqui a situação do pagamento antes de montar a condição.

O passo a passo completo da requisição está em Requisição externa: enviar e receber dados de outro sistema.

Se não funcionou

O teste mostra o código 401

O Mercado Pago não aceitou o token. Confira se copiou o Access Token de produção, inteiro, e se o cabeçalho tem Bearer, um espaço e o token.

O cliente pagou, mas a consulta não acha o pagamento

A consulta procura pela referência do contato. Confira se o corpo do link tem "external_reference": "{{user_id}}" e se a consulta usa o mesmo campo.

O caminho não bate com a resposta. Abra Testar Agora, veja o Corpo da resposta e corrija o caminho em Mapeamento de resposta. Veja Erros de requisição externa, webhook e planilha.

Faça com a IA

Copie o pedido e cole no ChatGPT ou no Claude.

Quero cobrar pelo Mercado Pago dentro de um fluxo da NexTags. Leia esta página: https://help.nextags.com.br/integracoes/mercado-pago.md

O que eu vendo: [produto ou serviço e valor]. Monte as duas requisições, criar o link e conferir o pagamento, com o Request Type, a Request URL, os cabeçalhos, o corpo e os caminhos do Mapeamento de resposta, e escreva as mensagens do fluxo para pago, pendente e recusado. Não me peça o Access Token.

Relacionados

Este conteúdo ajudou?

Obrigado! Sua resposta ajuda a melhorar a central.