> For the complete documentation index, see [llms.txt](https://docs.mavibot.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mavibot.ai/doc/pt/integrations/payment/mercado-pago.md).

# Mercado Pago

Para usar o sistema de pagamento Mercado Pago, conclua as configurações abaixo no painel do Mercado Pago Developers e depois insira os detalhes nas configurações de integração.

## Aplicação e Access Token

1. Faça login no Mercado Pago e abra a seção Developers (**Developers / Suas integrações**).
2. Crie uma aplicação (**Suas integrações → Criar aplicação**) se você ainda não tiver uma.
3. Copie seu **Access Token de Produção** ou **Access Token de Teste** — esse token será usado como o token principal da API.

<div data-with-frame="true"><figure><img src="/files/eebbfe3dcd64ad09e3f5691400cf6ed7a0d47d0e" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Para informações sobre os tipos de token e onde encontrá-los, veja: [Credenciais.](https://www.mercadopago.com.br/developers/en/docs/your-integrations/credentials)
{% endhint %}

## Webhooks (notificações de pagamento)

1. Nas configurações de integração, abra a **Webhooks / notificações** seção (veja: [**Webhooks**](https://www.mercadopago.com.br/developers/en/docs/your-integrations/notifications/webhooks)).
2. Defina a URL de notificação:

`https://chatter.mavibot.ai/mercado_pago_callback/result`

3. Assine os eventos de **Pagamentos** para que você possa receber notificações sobre criação de pagamentos e atualizações de status.
4. Salve o **segredo do Webhook** — ele deve ser inserido nas configurações de integração.

<div data-with-frame="true"><figure><img src="/files/e0973faf561393e15cb5d450f2530d43f0985c42" alt=""><figcaption></figcaption></figure></div>

## Conectando ao Mavibot

Na seção Acquiring, selecione **Mercado Pago**.

<div data-with-frame="true"><figure><img src="/files/aa1719f0c0a3fff088c79bab022866118b0cdf53" alt=""><figcaption></figcaption></figure></div>

Em seguida, insira:

* **Access Token** — o token que você copiou.
* **segredo do Webhook** — o segredo usado para verificar webhooks.

<div data-with-frame="true"><figure><img src="/files/1bc1607c2a745cfa66cce7cf34ba9879c920d94d" alt=""><figcaption></figcaption></figure></div>

## Geração de link de pagamento

Função do calculador:\
`get_mercado_pago_payment_url(amount, description, currency, customer_email, product_name)`

<table data-header-hidden><thead><tr><th width="241.3828125"></th><th></th></tr></thead><tbody><tr><td>Parâmetros</td><td>Descrição</td></tr><tr><td><mark style="color:$danger;"><strong>!</strong></mark><strong> amount</strong></td><td><p><strong>Valor do pagamento.</strong></p><p>Este é um parâmetro obrigatório.</p></td></tr><tr><td><strong>description</strong></td><td><p><strong>Descrição do pagamento.</strong> </p><p>Este é um parâmetro opcional.</p></td></tr><tr><td><strong>currency</strong></td><td><strong>Código ISO da moeda</strong> (por exemplo, BRL, ARS, MXN, USD, EUR, CLP, COP, PEN, UYU) — opcional; o padrão é BRL.</td></tr><tr><td><strong>customer_email</strong></td><td><strong>E-mail do cliente</strong> — opcional.</td></tr><tr><td><strong>product_name</strong></td><td><p><strong>Nome alternativo do produto</strong> — opcional; </p><p>se não for fornecido, a descrição será usada no lugar.</p></td></tr></tbody></table>

A função retorna um link de pagamento.

<div data-with-frame="true"><figure><img src="/files/947467b76dafe5c34c71e37058fb495bafff273c" alt=""><figcaption><p>Este exemplo mostra como passar parâmetros para a função e enviar o link de pagamento em uma mensagem.</p></figcaption></figure></div>

## Pagamento via botão

Para enviar um botão de pagamento via Mercado Pago, selecione um tipo de botão com suporte a pagamento no construtor de botões e escolha **Mercado Pago** como o sistema de pagamento. Insira o valor, a descrição e a moeda, se necessário.

<div data-with-frame="true"><figure><img src="/files/86382159983dc7041d64539848be0f0276a2ebc9" alt=""><figcaption></figcaption></figure></div>

## Callbacks no diálogo após o pagamento

### **Pagamento bem-sucedido**

Depois que o cliente seguir o link e concluir um pagamento com sucesso, um callback pode ser enviado ao diálogo no seguinte formato:

`<primeiros_10_caracteres_do_Webhook_secret>_success <amount>`

<div data-with-frame="true"><figure><img src="/files/48ccaa3cea90b15cf04cb1b06860c7e0d1a163a3" alt="" width="524"><figcaption></figcaption></figure></div>

**Exemplo:**\
`gltubgnDle_success 100` — onde o prefixo são os 10 primeiros caracteres do seu Webhook secret, e `100` é o valor do pagamento.

### Como adicionar uma reação a um pagamento bem-sucedido

Para enviar uma mensagem ao seu cliente após um pagamento bem-sucedido (por exemplo, “Pagamento concluído com sucesso” ou qualquer outra mensagem), você precisa configurar uma reação usando um bloco com um gatilho e um callback.

#### Etapa 1

Crie um bloco com uma condição (bloco Início ou bloco Gatilho).

<div data-with-frame="true"><figure><img src="/files/63a365fb1bfcf0ce4678166e2d6e93e56cce4de1" alt=""><figcaption><p>Este é o bloco Início com um callback no campo Trigger</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/5850e552bd8e309da94793532d161e71f330455d" alt=""><figcaption><p>Este é o bloco Gatilho com um callback no campo Trigger</p></figcaption></figure></div>

#### Etapa 2

Especifique parte do callback (se você precisar reagir a todos os pagamentos, por exemplo, quando tiver vários produtos diferentes) ou o callback completo (se quiser configurar uma reação apenas para a venda de um produto específico).

<div data-with-frame="true"><figure><img src="/files/66266c46396ee2893b6ae9e03dbd8ed37d51243f" alt=""><figcaption><p>Se você precisar configurar uma resposta para quaisquer pagamentos no projeto,<br>deixe uma parte do callback e selecione o tipo de correspondência "Keywords match"</p></figcaption></figure></div>

#### Etapa 3

Escreva a mensagem de resposta para um pagamento bem-sucedido e salve o bloco.Etapa 3. Escreva a mensagem de reação para um pagamento bem-sucedido e salve o bloco.

<div data-with-frame="true"><figure><img src="/files/d0994ca78ce10dd0db57537d773831a16159a567" alt=""><figcaption></figcaption></figure></div>

### Pagamento com falha

Se o pagamento não for bem-sucedido (recusado, cancelado etc., dependendo do status na API), um callback pode ser enviado no seguinte formato:

`<primeiros_10_caracteres_do_Webhook_secret>_fail <amount>`

<div data-with-frame="true"><figure><img src="/files/16347aa5cf3c4e05488b9531ed9ebc13f4c03913" alt="" width="563"><figcaption></figcaption></figure></div>

**Exemplo:**\
`gltubgnDle_fail 100` — onde o prefixo são os 10 primeiros caracteres do seu Webhook secret, e `100` é o valor.

#### Como adicionar uma reação a um pagamento com falha

Para enviar uma mensagem ao seu cliente após um pagamento sem sucesso (por exemplo, “Pagamento com falha” ou qualquer outra mensagem), você precisa configurar uma reação usando um bloco com um gatilho e um callback.

{% hint style="info" %}
[Uma reação a pagamento com falha é configurada da mesma forma que uma bem-sucedida.](#how-to-add-a-reaction-to-a-successful-payment)
{% endhint %}

#### Etapa 1

Crie um bloco com uma condição (bloco Início ou bloco Gatilho).

#### Etapa 2

Especifique parte do callback (se você precisar reagir a todos os pagamentos, por exemplo, quando tiver vários produtos diferentes) ou o callback completo (se quiser configurar uma reação apenas para a venda de um produto específico).

#### Etapa 3

Escreva a mensagem de resposta para um pagamento com falha e salve o bloco.

### Variáveis do cliente após pagamento bem-sucedido

| Variáveis                         | Descrição                                                   |
| --------------------------------- | ----------------------------------------------------------- |
| mercado\_pago\_callback\_data     | Informações de pagamento recebidas do sistema de pagamento. |
| mercado\_pago\_payment\_completed | “True” — o pagamento foi processado com sucesso.            |
| mercado\_pago\_payment\_id        | ID do pagamento no Mercado Pago                             |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/pt/integrations/payment/mercado-pago.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.