O que é o WhatsApp Payments?

O WhatsApp Payments é um recurso de apresentação de pagamentos desenvolvido pela Meta para facilitar a experiência do usuário ao receber pedidos e links de pagamento pelo WhatsApp. Ele não processa o pagamento, mas exibe de forma amigável o resumo do pedido, o valor total e as ações para que o cliente finalize a compra em uma plataforma externa.

Considerações Iniciais

• Botmaker e WhatsApp não processam os pagamentos: a cobrança ocorre exclusivamente por meio de um gateway externo (ex: Mercado Pago, Adyen, PagarMe). O WhatsApp e a Botmaker apenas apresentam as informações.
• Integração prévia obrigatória: é necessário já ter o meio de pagamento externo configurado e gerar os links, tokens (Pix), códigos de boleto etc. fora da Botmaker.
• Canal e suporte geográfico: atualmente disponível apenas para números de telefone do Brasil com DDI +55 e exclusivamente via WhatsApp (não funciona em outros canais).
• Forma de apresentação: o usuário recebe um “box” mais visual e amigável, com informações-chave e um botão de pagamento ou código para copiar e colar.

Tipos de pagamento suportados

Atualmente, a Meta aceita os seguintes métodos de pagamento via WhatsApp Payments:

• Link de pagamento
• Pix (com cópia e colagem do código/token)
• Boleto (linha digitável, com botão de “copiar” para uso no banco)

Qualquer gateway que permita gerar um link, token Pix ou boleto pode ser integrado na ação, desde que a variável correspondente esteja disponível.

Por que usar o WhatsApp Payments?

• Apresenta solicitações de pagamento de forma muito mais profissional e clara.
• Reduz riscos e dúvidas para o usuário, ao exibir um resumo e um call to action em um formato visual nativo.
• Permite oferecer múltiplas formas de pagamento (Pix, link, boleto) seguindo a mesma lógica.
• Suporta cupons, descontos, taxas de envio e outras variáveis (tanto a nível do produto quanto do pedido).

Como criar a ação “Mensagem de pagamento do WhatsApp” no seu fluxo?

Dentro do seu bot, adicione a ação correspondente:

• Texto principal: mensagem de ajuda ou contexto para o usuário (limite aproximado de 1.000 caracteres).
  
• Imagem (opcional): imagem informativa associada ao pedido.
  
• Rodapé (opcional): exemplo: “O link expira em 15 minutos”.
  
• Método de pagamento: Link, Pix ou Boleto.
  
• Variável do método selecionado: URL do link de pagamento, token do Pix ou linha digitável do boleto.
  
• Identificador do usuário: pode ser o telefone, e-mail ou CPF (especialmente necessário para Pix/boletos).
  
• Ordem do pagamento: você pode gerar um ID único por fluxo ou usar o ID fornecido pelo seu sistema.
  
• Taxas, frete e descontos: é possível adicionar taxas fixas ou variáveis, além de aplicar descontos por produto ou sobre o total do pedido.

É recomendável fazer os cálculos de descontos com antecedência e enviar apenas os valores finais à Botmaker, para evitar inconsistências.

Exemplo de estrutura de produtos:

[

 {

   "amount": 12.23,

   "quantity": 2,

   "name": "Producto 1",

   "retailer_id": "1",

   "sale_amount": 11.23

 },

 {

   "amount": 12.23,

   "quantity": 1,

   "name": "Producto 2",

   "retailer_id": "2",

   "sale_amount": 11.23

 }

]

Inclui: nome, SKU, quantidade, preço e preço com desconto.

Ações pós-pagamento: Como gerenciar o “pagamento aprovado” ou “pagamento rejeitado”?

Botmaker e WhatsApp não detectam pagamentos com confirmação imediata. Para registrar se o pagamento foi aprovado ou rejeitado, você precisa receber o callback (webhook) de confirmação do seu gateway e ajustar o fluxo no bot, alterando variáveis e direcionando o usuário pelo fluxo correto.

• Pagamento aprovado: Quando o gateway retorna confirmação via webhook (pagamento recebido), mostra uma mensagem de sucesso ou gera o pedido.
  
  
• Pagamento rejeitado: Se o pagamento for rejeitado ou expirar, exibe uma mensagem de erro e permite que o usuário tente novamente, se necessário.