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.

Para informações sobre os tipos de token e onde encontrá-los, veja: Credenciais.

Webhooks (notificações de pagamento)

1. Nas configurações de integração, abra a Webhooks / notificações seção (veja: Webhooks).

2. Defina a URL de notificação:

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

1. Assine os eventos de Pagamentos para que você possa receber notificações sobre criação de pagamentos e atualizações de status.

2. Salve o segredo do Webhook — ele deve ser inserido nas configurações de integração.

Conectando ao Mavibot

Na seção Acquiring, selecione Mercado Pago.

Em seguida, insira:

• Access Token — o token que você copiou.

• segredo do Webhook — o segredo usado para verificar webhooks.

Geração de link de pagamento

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

Parâmetros	Descrição
! amount	Valor do pagamento. Este é um parâmetro obrigatório.
description	Descrição do pagamento. Este é um parâmetro opcional.
currency	Código ISO da moeda (por exemplo, BRL, ARS, MXN, USD, EUR, CLP, COP, PEN, UYU) — opcional; o padrão é BRL.
customer_email	E-mail do cliente — opcional.
product_name	Nome alternativo do produto — opcional; se não for fornecido, a descrição será usada no lugar.

A função retorna um link de pagamento.

Este exemplo mostra como passar parâmetros para a função e enviar o link de pagamento em uma mensagem.

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.

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>

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

Este é o bloco Início com um callback no campo Trigger

Este é o bloco Gatilho com um callback no campo Trigger

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

Se você precisar configurar uma resposta para quaisquer pagamentos no projeto, deixe uma parte do callback e selecione o tipo de correspondência "Keywords match"

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.

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>

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.

Uma reação a pagamento com falha é configurada da mesma forma que uma bem-sucedida.

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