Skip to main content
Uma vez conectada a integração, o nó do Mercado Pago fica disponível no Canvas e permite criar experiências de cobrança com WebView embarcado dentro do fluxo conversacional.
Primeira vez implementando uma cobrança? Siga primeiro o Tutorial: sua primeira cobrança.Se ainda não instalou a integração, comece por Conectar no Brain Studio.

Adicionar o nó ao Canvas

1

Abrir seu fluxo no Canvas

Abra no Brain Studio o fluxo onde deseja incorporar a cobrança com Mercado Pago.
2

Adicionar o nó Mercado Pago

Adicione Mercado Pago a partir da barra de ferramentas do Canvas, no nó Pagamentos, ou a partir dos provedores de pagamento disponíveis após instalar a integração.O ponto exato pode variar conforme tenha iniciado a instalação pelo Marketplace, Jelou Agent, nó de pagamentos no Canvas ou template.
3

Conectar o nó ao ponto de cobrança

Conecte o nó do Mercado Pago depois que o fluxo já tiver o valor, os dados do comprador e a confirmação da compra.
4

Abrir o painel de configuração

Selecione o nó para abrir o painel lateral direito. Preencha as abas Dados do pagamento e Avançado e revise as saídas disponíveis no nó do Canvas.Se faltarem campos obrigatórios, o nó exibe o aviso Configuração incompleta. Revise os campos do nó. e o badge de ambiente (Desenvolvimento ou Produção).

Configurar o nó

Nó Mercado Pago no Canvas com a aba Dados do pagamento aberta no painel lateral

Aba Dados do pagamento: personalização, valores e email do comprador

boolean
padrão:"false"
Ative para definir as mensagens que acompanham seu botão de pagamento.Quando ativo, habilita os campos Header, Body e Footer.
Exemplo de mensagem com textos personalizados e botão de pagamento do Mercado Pago no WhatsApp

Exemplo de mensagem com botão de pagamento personalizado no WhatsApp

string
Título da mensagem do botão de pagamento.Exibido quando Personalização está ativa.
string
Texto principal da mensagem do botão de pagamento.Exibido quando Personalização está ativa.
string
obrigatório
Texto descritivo da cobrança. Exemplos: número do pedido, produto, serviço ou referência interna.
number
obrigatório
Valor sobre o qual se aplica IVA ou outro imposto configurado. Somente números.
number
obrigatório
Valor isento de impostos. Somente números. Se não se aplicar, use 0.
string
obrigatório
Email do comprador que usará o checkout.Em Desenvolvimento, deve ser o email de um usuário de teste do Mercado Pago do país correspondente.Em Produção, use o email real do comprador capturado no fluxo.
Se a integração estiver em Desenvolvimento, copie um destes emails de teste em Email do comprador. Deve ser do mesmo país das suas credenciais de teste.

Saídas do nó

As saídas aparecem no nó do Mercado Pago no Canvas. Conecte-as conforme o resultado que deseja tratar no fluxo.
Ativa quando o Mercado Pago confirma que a transação foi aprovada.Recomendações:
  • confirmar o pedido
  • emitir comprovante ou notificação
  • atualizar o status da compra em seus sistemas
Ativa quando a transação fica em processamento ou requer confirmação posterior.Recomendações:
  • informar o usuário com clareza
  • evitar criar uma segunda cobrança enquanto o status é resolvido
  • aguardar atualização por webhook ou consulta posterior quando corresponder
Ativa quando a mensagem com o botão de pagamento é enviada com sucesso na conversa.Esta saída não confirma o pagamento. Apenas indica que a mensagem com o botão de pagamento foi enviada com sucesso na conversa.Você pode conectar esta saída a um AI Agent de suporte pós-envio da mensagem de pagamento para auxiliar o usuário enquanto decide abrir o checkout ou se tiver dúvidas antes de pagar.Recomendações:
  • resolver dúvidas sobre como abrir o botão de pagamento
  • ajudar se o WebView não carregar ou o usuário não entender a etapa
  • evitar criar uma nova cobrança sem contexto
  • não confirmar pagamentos a partir desta saída
Exemplo de prompt (referencial):
Ativa quando a transação foi rejeitada, recusada, negada ou não foi concluída.Recomendações:
  • permitir nova tentativa controlada
  • oferecer rota de suporte ou caminho alternativo
Ativa diante de erros técnicos, erros do provedor ou falhas de comunicação durante a criação ou o processamento do pagamento.Recomendações:
  • registrar o erro
  • exibir mensagem de contingência
  • tentar novamente de forma controlada e escalar se persistir

Testar pagamentos em modo teste

Se o Mercado Pago estiver conectado com credenciais de teste, o checkout deve ser concluído com um usuário de teste do Mercado Pago.
Em modo teste, o pagamento é fictício e não movimenta dinheiro real. O ambiente Desenvolvimento no nó corresponde a credenciais de teste do Mercado Pago.
1

Confirmar credenciais de teste

Verifique se o Mercado Pago está instalado com um Access Token de Credenciais de teste.
2

Configurar o nó em ambiente de teste

Na aba Avançado, verifique se o ambiente corresponde a Desenvolvimento.
3

Usar um email de usuário de teste

Em Email do comprador, use um test user do mesmo país das credenciais conectadas.A lista completa por país está no tutorial de primeira cobrança.
4

Testar pelo WhatsApp

Dispare o fluxo pelo WhatsApp, abra o checkout WebView do Mercado Pago e conclua o pagamento com os cartões de teste do país correspondente descritos no tutorial.
5

Validar a saída do fluxo

Verifique por qual saída o fluxo continua:
  • Mensagem de pagamento enviada (apenas envio do botão)
  • Pagamento bem-sucedido
  • Pagamento pendente
  • Pagamento falhou
  • Erro

Passar para produção

Se instalou o Mercado Pago com credenciais de teste, pode iniciar a passagem para produção na aba Avançado do nó Mercado Pago no Canvas ou na página do Mercado Pago no Marketplace. Em ambos os casos, abre-se o mesmo modal para inserir o Access Token produtivo e confirmar a configuração. Antes de operar com pagamentos reais:
  • Certifique-se de ter um Access Token de Credenciais de produção no Mercado Pago.
  • Use o fluxo Passar para produção descrito em Conectar no Brain Studio.
  • Confirme que Moeda e Percentual de IVA no nó coincidem com a configuração produtiva.
  • Substitua no nó qualquer dado de teste por dados reais do fluxo.
  • Em produção, use o email real do comprador.
  • Execute um teste real de valor baixo antes de escalar.

Considerações importantes

Se instalou o Mercado Pago com credenciais de teste, use usuários de teste e emails de teste. Se instalou com credenciais de produção, use dados reais do comprador.
Em testes, Email do comprador deve pertencer a um usuário de teste do Mercado Pago do país correspondente.Se usar um email real em Desenvolvimento, o checkout pode falhar ou não continuar pela saída esperada.
A Moeda e o Percentual de IVA do nó devem coincidir com o definido ao instalar a integração e com o país das credenciais do Mercado Pago.
Em cenários pendentes ou falhos, informe com clareza o usuário antes de iniciar uma nova tentativa de cobrança. Mantenha novas tentativas controladas.
Alguns meios do Mercado Pago podem ficar pendentes antes de serem creditados. Seu fluxo deve tratar Pagamento pendente sem assumir que a cobrança já foi confirmada.
Para que o checkout abra dentro do WhatsApp, a conta deve ser WhatsApp Business verificada. Se não estiver verificada, o checkout abrirá no navegador externo do dispositivo. Revise o aviso em Conectar no Brain Studio.

Próximo passo

Cobertura e preços

Revise disponibilidade por país, meios de pagamento e tarifas de referência do Mercado Pago.