# 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.

Endereço: https://help.nextags.com.br/integracoes/mercado-pago/
Tipo: Integração

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

- Mandar na conversa um link de pagamento com o valor e a descrição do que o cliente compra. Veja [Requisição externa: enviar e receber dados de outro sistema](https://help.nextags.com.br/tutoriais/fluxos/requisicao-externa/).
- Conferir se o pagamento foi aprovado e seguir o fluxo conforme a resposta. Veja [Etapa Condição: caminhos diferentes para cada contato](https://help.nextags.com.br/tutoriais/fluxos/condicoes/).
- Marcar como pago o pedido do E-commerce da NexTags quando o pagamento for aprovado. Veja [Carrinho e pedidos na conversa](https://help.nextags.com.br/tutoriais/ecommerce/carrinho-e-pedidos/).

## Como conectar

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

No Mercado Pago, entre em [Suas integrações](https://www.mercadopago.com.br/developers/panel/app) 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](https://help.nextags.com.br/tutoriais/fluxos/campos-do-bot/). Mais detalhes na [documentação do Mercado Pago](https://www.mercadopago.com.br/developers/pt/docs/your-integrations/credentials).

### 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.

![Janela External Request: tipo POST, endereço da API e, na aba Cabeçalhos, o cabeçalho Authorization com a chave guardada num campo.](https://help.nextags.com.br/_img/fluxos-acoes/requisicao.webp)
*Uma requisição POST com o cabeçalho Authorization. O endereço do print é um exemplo.*

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:

```json
{
  "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.

![Aba Mapeamento de resposta: cada JSONPath da resposta com o campo personalizado onde o valor fica salvo.](https://help.nextags.com.br/_img/fluxos-acoes/requisicao-mapeamento.webp)
*Cada caminho da resposta com o campo que guarda o valor.*

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.

![Aba Testar Agora com o resultado do teste: código do estado 200, corpo da resposta e os cabeçalhos e o corpo da solicitação.](https://help.nextags.com.br/_img/fluxos-acoes/requisicao-testar.webp)
*O resultado do Testar Agora.*

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](https://help.nextags.com.br/tutoriais/fluxos/requisicao-externa/).

## 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 campo do link ou da situação ficou vazio

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](https://help.nextags.com.br/tutoriais/erros/erros-de-requisicao-externa/).

### Faça com a IA

Cole este pedido no ChatGPT ou no Claude:

```text
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.
```