Para usar o sistema de pagamento Mercado Pago, complete as configurações abaixo no seu painel Mercado Pago Developers e, em seguida, insira os detalhes nas configurações de integração.
Aplicação e Access Token
- Faça login no Mercado Pago e abra a seção Developers (Developers / Suas integrações).
- Crie uma aplicação (Your integrations → Create application) se ainda não tiver uma.
- Copie seu Production Access Token ou Test Access Token — este token será usado como o token principal da API.
Para informações sobre tipos de token e onde encontrá-los, consulte: Credentials.
Webhooks (notificações de pagamento)
- Nas configurações de integração, abra a seção Webhooks / уведомления (consulte: Webhooks).
- Defina a URL de notificação:
https://chatter.mavibot.ai/mercado_pago_callback/result
- Inscreva-se nos eventos de Payments para receber notificações sobre criação de pagamento e atualizações de status.
- Salve o Webhook secret — 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.
- Webhook secret — o segredo usado para verificar webhooks.
Geração de link de pagamento
Função da calculadora:
get_mercado_pago_payment_url(amount, description, currency, customer_email, product_name)
A função retorna um link de pagamento.
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 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
Após o cliente seguir o link e concluir um pagamento bem-sucedido, 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 primeiros 10 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.
Passo 1
Crie um bloco com uma condição (bloco Start ou Trigger).
Passo 2
Especifique parte do callback (se precisar reagir a todos os pagamentos, por exemplo, quando você tem vários produtos diferentes), ou o callback completo (se quiser configurar uma reação apenas para a venda de um produto específico).
Passo 3
Escreva a mensagem de resposta para um pagamento bem-sucedido e salve o bloco.
Pagamento falhou
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 primeiros 10 caracteres do seu Webhook secret, e 100 é o valor.
Como adicionar uma reação a um pagamento falho
Para enviar uma mensagem ao seu cliente após um pagamento malsucedido (por exemplo, “Pagamento falhou” ou qualquer outra mensagem), você precisa configurar uma reação usando um bloco com um gatilho e um callback.
Uma reação de pagamento falho é configurada da mesma forma que uma bem-sucedida.
Passo 1
Crie um bloco com uma condição (bloco Start ou Trigger).
Passo 2
Especifique parte do callback (se precisar reagir a todos os pagamentos, por exemplo, quando você tem vários produtos diferentes), ou o callback completo (se quiser configurar uma reação apenas para a venda de um produto específico).
Passo 3
Escreva a mensagem de resposta para um pagamento falho 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 como bem-sucedido. |
| mercado_pago_payment_id | ID do pagamento no Mercado Pago |