Para cobrar com Pix dentro da conversa do WhatsApp de forma estruturada, a empresa precisa da API oficial (WhatsApp Business Platform, via Cloud API): ela envia uma mensagem de pedido (order_details) com um código Pix dinâmico gerado pelo seu banco ou PSP (prestador de serviços de pagamento), o cliente toca em copiar, paga no app do banco e a empresa atualiza o pedido para “pago” na própria conversa. O WhatsApp só transporta a cobrança; quem gera o Pix, recebe o dinheiro e confirma o pagamento é a instituição financeira da empresa.
Quem usa apenas o app WhatsApp Business pode enviar chave Pix, QR Code ou link de cobrança como mensagem comum, mas sem o botão de pagamento, sem o status “pago” automático e sem conciliação. Este guia mostra os dois caminhos, o que a documentação da Meta exige e onde estão os custos.
Resumo rápido
- A Payments API do Brasil aceita Pix dinâmico, link de pagamento, boleto e pagamento com cartão em um clique (este ainda não é público).
- O WhatsApp não processa nem concilia o pagamento: você precisa de integração com banco ou PSP que gere o Pix dinâmico e avise quando ele for pago.
- Há duas formas de enviar a cobrança: mensagem
order_detailsdentro da janela de 24 horas ou template com botão de solicitação de pagamento.- Desde 1º de outubro de 2026, a Meta cobra por mensagem também as mensagens de serviço e os templates de utilidade enviados dentro da janela de atendimento.
- A Meta não publica taxa própria sobre o valor do Pix na API; o custo da transação, quando existe, é do seu banco ou PSP.
App WhatsApp Business ou API: dois caminhos diferentes
O app WhatsApp Business é o aplicativo gratuito instalado no celular. A página oficial de recursos do app cita catálogo, carrinho, criação de pedidos com faturas e pagamentos com cartão, mas a Meta não publica, nas páginas oficiais que consultamos, um fluxo de Pix nativo para o app. Na prática, quem atende pelo app cobra com Pix enviando a chave, um QR Code ou um link gerado pelo banco como mensagem comum, e confere o recebimento no extrato.
A WhatsApp Business Platform é a API oficial, usada por sistemas, CRMs e chatbots. É nela que existe a documentação da Payments API para o Brasil, com mensagens interativas de pedido, status de pagamento e templates com botão de Pix. Se a sua empresa ainda não usa a API, comece pelo nosso guia de integração do n8n com a Cloud API, que explica número, token e webhooks.
| Critério | App WhatsApp Business | API (WhatsApp Business Platform) |
|---|---|---|
| Como o Pix chega ao cliente | Texto com chave, QR Code em imagem ou link do banco | Mensagem de pedido ou template com botão “copiar código Pix” |
| Status “pago” na conversa | Não | Sim, quando a empresa envia a atualização com pagamento captured |
| Conciliação | Manual, pelo extrato | Pelo identificador do pedido (reference_id) junto ao PSP |
| Escala e automação | Um ou poucos atendentes | Chatbots, agentes de IA, CRM e ERP |
| Custo de mensagens | App gratuito | Cobrança por mensagem conforme categoria e país |
Como funciona a cobrança com Pix pela API
A documentação da Meta descreve um fluxo em quatro etapas: o cliente conversa e escolhe o produto; a empresa envia uma mensagem order_details; o cliente copia o código Pix e paga no aplicativo do banco usando o Pix Copia e Cola; a empresa envia uma mensagem order_status indicando que o pedido está em processamento.
O ponto central está na página de Pix da Meta: nessa integração, o WhatsApp apenas facilita a comunicação entre empresa e comprador. A empresa é responsável por integrar com um banco ou PSP para gerar códigos Pix dinâmicos e confirmar o pagamento. A Meta também deixa claro que o WhatsApp não faz conciliação de pagamentos.
Por que Pix dinâmico
Pelo Manual de Padrões para Iniciação do Pix, do Banco Central, o QR Code estático traz todos os dados dentro do próprio código e tem poucas opções; o dinâmico contém uma URL consultada no momento da leitura, o que permite conciliação pelo identificador da transação, valor configurado e campos estruturados. Quem pode emitir o QR Code Pix é o PSP do recebedor. Por isso a mensagem de pedido no WhatsApp leva um código gerado pelo seu banco para aquela cobrança específica, e não a chave Pix genérica da empresa.
O que vai na mensagem
Na versão simplificada, sem lista de itens, o essencial é este trecho do campo action:
"name": "review_and_pay",
"parameters": {
"reference_id": "pedido-1042",
"type": "physical-goods",
"payment_type": "br",
"currency": "BRL",
"total_amount": { "value": 8900, "offset": 100 },
"payment_settings": [{
"type": "pix_dynamic_code",
"pix_dynamic_code": {
"code": "000201...br.gov.bcb.pix...",
"merchant_name": "Nome do titular",
"key": "CNPJ da empresa",
"key_type": "CNPJ"
}
}]
}Regras da documentação que costumam gerar erro: o reference_id deve ser único para cada mensagem de pedido (até 60 caracteres, só letras, números, sublinhado, hífen ou ponto); o valor vai em centavos com offset 100; o tipo deve ser digital-goods ou physical-goods. É possível incluir o objeto order com itens, frete e desconto, e uma expiração, depois da qual o botão de pagamento fica desativado para o cliente.
Formas de cobrar na conversa pela API
Além do Pix dinâmico, a Payments API do Brasil lista outras integrações. Todas seguem a mesma lógica: a Meta mostra a cobrança, o seu PSP processa.
| Forma | Como o cliente paga | Exige | Observação |
|---|---|---|---|
Pix dinâmico (pix_dynamic_code) |
Copia o código e paga no app do banco | Banco ou PSP que gere Pix dinâmico e avise o pagamento | Empresa atualiza o status após a confirmação |
Link de pagamento (payment_link) |
Abre o checkout do PSP no navegador | PSP com links de pagamento | Permite Pix, cartão ou outros meios oferecidos pelo PSP |
| Boleto | Copia a linha digitável | PSP que emita boletos | Mesmo fluxo de pedido e status |
Cartão em um clique (offsite_card_pay) |
Confirma com cartão já salvo pela empresa | PSP e credenciais armazenadas pela empresa | Ainda não público; liberado via Solution Partner |
| Template com botão de solicitação de pagamento | Botão de Pix, boleto ou link dentro de um template | Template aprovado no WhatsApp Manager | Dispensa a integração com order_details; em liberação gradual |
O template com botão de solicitação de pagamento é útil para cobranças fora da janela de 24 horas, como lembrete de mensalidade. Segundo a Meta, ele aceita até três botões de pagamento na mesma mensagem, cada um com um método, e é criado nas categorias Utilidade ou Marketing, passando pela revisão normal de templates. Também existem templates de detalhes do pedido com botão de Pix.
Passo a passo para implantar
- Escolha o PSP. Confirme com seu banco ou intermediador se ele gera cobranças Pix com QR Code dinâmico por API e se envia notificação (webhook) quando o Pix é pago. Sem isso, não há como marcar o pedido como pago automaticamente.
- Tenha a API do WhatsApp ativa. Número registrado na WhatsApp Business Platform, diretamente pela Cloud API ou por um parceiro (Solution Partner). Recursos de pagamento podem estar em liberação gradual na sua conta.
- Gere a cobrança. Quando o cliente fecha o pedido, seu sistema cria a cobrança Pix no PSP e guarda o identificador junto ao
reference_idque irá para o WhatsApp. - Envie o pedido. Mande a mensagem
order_detailscom o código Pix, dentro da janela de atendimento, ou um template com botão de pagamento. - Confirme e atualize. Ao receber o aviso do PSP, envie o
order_statuscom o pagamentocaptured; o pedido ganha a etiqueta de pago na conversa. Depois, use os status de envio e conclusão. - Cancele quando preciso. O status
canceledfalha se já houver pagamento realizado ou pendente para aquele pedido, então trate esse erro no seu fluxo.
Os webhooks do PSP são a parte mais sensível. Nosso guia sobre webhooks de pagamentos com Pix e cartão mostra como validar assinaturas e evitar notificações duplicadas.
Custos: o que a Meta cobra e o que o banco cobra
São dois custos separados. O primeiro é o das mensagens. Desde 1º de julho de 2025, a Meta cobra por mensagem entregue, com valores que variam conforme a categoria do template e o código de país do destinatário. Pela página de atualizações de preço da Meta, a partir de 1º de outubro de 2026 passaram a ser cobradas também as mensagens de serviço (respostas fora de template dentro da janela de 24 horas) e os templates de utilidade enviados dentro dessa janela, que antes eram gratuitos. Como a mensagem de pedido é uma resposta dentro da conversa, inclua esse custo na conta e consulte a tabela vigente no WhatsApp Manager ou com seu parceiro.
O segundo é o da transação. A documentação da Payments API não informa taxa da Meta sobre o valor pago, porque o dinheiro não passa pelo WhatsApp. A tarifa de recebimento de Pix, quando existe para empresas, é definida pelo contrato com o seu banco ou PSP. Pergunte também se a emissão de QR Code dinâmico tem custo por cobrança.
Exemplo: uma confeitaria em Belo Horizonte
Imagine uma confeitaria em Belo Horizonte que recebe encomendas de bolos pelo WhatsApp. Hoje a atendente manda a chave Pix, o cliente envia o comprovante em foto e alguém confere o extrato no fim do dia, o que gera dúvida quando dois clientes pagam o mesmo valor.
Com a API, o assistente de atendimento monta o pedido (sabor, tamanho, data de retirada), o sistema cria a cobrança Pix dinâmica no banco da confeitaria e envia a mensagem de pedido com os itens e uma expiração no fim do dia. O cliente copia o código e paga. Quando o banco avisa o pagamento, o sistema envia a atualização de status, e a conversa mostra o pedido como pago. Como cada cobrança tem identificador próprio, a conciliação deixa de depender do comprovante.
Para encomendas de clientes que somem antes de pagar, a confeitaria usa um template de utilidade com botão de Pix como lembrete. Se usar um agente de IA na conversa, as regras de abordagem do nosso guia de cobrança amigável pelo WhatsApp ajudam a não soar agressivo.
Erros comuns
- Mandar a chave Pix fixa em vez de código dinâmico. Sem identificador por cobrança, a conciliação volta a ser manual.
- Esperar que o WhatsApp confirme o pagamento. Ele não concilia. Se o seu sistema não enviar o status, o pedido fica pendente na conversa.
- Repetir o
reference_id. Ele precisa ser único por mensagem; para reenviar o mesmo pedido, acrescente um número de sequência. - Esquecer a janela de 24 horas. Fora dela, só templates aprovados podem ser enviados.
- Aceitar comprovante em imagem como prova. Comprovantes podem ser falsificados; confirme pela notificação do banco.
- Usar soluções não oficiais. Automação fora da API oficial arrisca o bloqueio do número; veja como colocar IA no WhatsApp sem risco de bloqueio.
Perguntas frequentes
O app WhatsApp Business tem botão de Pix?
A Meta não documenta, nas páginas oficiais consultadas, um fluxo de Pix nativo no app. O botão de copiar código Pix e o status de pagamento estão documentados na Payments API da plataforma. Verifique no seu aplicativo, porque recursos podem ser liberados aos poucos.
Preciso ser grande empresa para usar a Payments API?
A documentação não define porte mínimo. Os requisitos práticos são ter acesso à WhatsApp Business Platform e integração com um banco ou PSP que gere Pix dinâmico e confirme pagamentos.
O dinheiro passa pela Meta?
Não no Pix. O cliente paga no aplicativo do próprio banco, e o valor vai para a conta da empresa no banco ou PSP que gerou o código.
Posso oferecer Pix e boleto na mesma mensagem?
O campo de configurações de pagamento é uma lista, e os templates com botão de solicitação de pagamento aceitam até três botões, cada um com um método. Confira na documentação as combinações aceitas para o seu tipo de mensagem.
Um agente de IA pode enviar a cobrança sozinho?
Pode montar o pedido e disparar a mensagem pela API, mas valores, descontos e cancelamentos devem seguir regras fixas do sistema, não decisão livre do modelo. Para ver o que a Meta oferece em IA no WhatsApp, consulte as integrações da Meta AI.
Fontes e leitura recomendada
- Meta for Developers: Payments API Brasil (visão geral)
- Meta for Developers: pagamentos com Pix dinâmico
- Meta for Developers: Orders API (order_details e order_status)
- Meta for Developers: templates com botão de solicitação de pagamento
- Meta for Developers: preços da WhatsApp Business Platform
- Meta for Developers: atualizações de preço para mensagens de serviço e utilidade
- WhatsApp Business: recursos do app
- Banco Central: Manual de Padrões para Iniciação do Pix
