Visão geral
A cobrança é o coração do módulo. Você cria uma cobrança com valor, descrição e itens, escolhe o método (PIX, boleto ou cartão via checkout hospedado) e a envia direto na conversa. O cliente recebe um cartão de pagamento na própria janela — com QR Code e copia-e-cola do PIX, a linha digitável do boleto ou o link do checkout — e o status é atualizado quando o gateway confirma.
Há três formas de partir para uma cobrança: avulsa (digita os valores), a partir do catálogo (escolhe produtos prontos) ou a partir de um negócio do CRM (reaproveita o valor já registrado).
Pré-requisitos
- Um gateway conectado e válido (veja Conectar gateway).
- Para cobrar do catálogo, o módulo de Catálogo habilitado e produtos cadastrados.
- Para cobrar de um negócio, o módulo de CRM habilitado e um negócio com valor.
- Um contato com dados mínimos (nome e, idealmente, e-mail e telefone) para o cliente do gateway.
Passo a passo
- Em uma conversa, abra a ação de criar cobrança (ou crie pela área de Pagamentos).
- Escolha a origem do valor:
- Avulsa: informe valor, descrição e, se quiser, itens (linhas de cobrança).
- Catálogo: selecione os produtos; o valor é somado automaticamente.
- Negócio: selecione um negócio do CRM; o valor é reaproveitado.
- Selecione o método de pagamento: PIX, boleto ou cartão (checkout hospedado).
- (Opcional) Aplique desconto ou ajuste o valor — veja Descontos e ajuste de valor.
- Defina o vencimento, quando aplicável.
- Crie a cobrança. A plataforma gera o PIX (QR + copia-e-cola), o boleto (linha digitável) ou o link do checkout, conforme o método.
- Envie na conversa: o cartão de pagamento aparece para o cliente na mesma janela.
- Acompanhe o status mudar de pendente para pago automaticamente quando o gateway confirmar.
Configurações & opções
- Métodos: PIX (QR Code + copia-e-cola), boleto (linha digitável/PDF) e cartão via checkout hospedado — a plataforma nunca pede o número do cartão.
- Itens (linhas de cobrança): descreva cada produto/serviço com quantidade e valor; o total é a soma das linhas.
- Vencimento: data limite para PIX/boleto.
- Marcar como pago manualmente: registre pagamentos recebidos por fora (quando o gateway suportar), para manter o histórico coerente.
- Reenviar: é possível reenviar o cartão de pagamento na conversa a qualquer momento.
Casos de uso
- Fechar a venda no WhatsApp e mandar o PIX na hora.
- Montar uma cobrança com vários itens a partir do catálogo.
- Cobrar um negócio ganho no CRM sem redigitar o valor.
- Oferecer ao cliente a escolha entre PIX e cartão.
Dicas, limites e boas práticas
- Valores são em unidades maiores (R$ 49,90 =
49.90); o total é a soma de preço × quantidade das linhas — nunca divida por 100. - O cartão sempre passa pelo checkout hospedado do gateway: zero dados de cartão na plataforma.
- Confirme nome e contato do cliente antes de criar — o gateway usa esses dados para identificar o pagador.
- Não confie na tela de "sucesso": o status real chega pelo webhook.
Solução de problemas
- Erro ao criar a cobrança: verifique se o gateway está conectado e se o contato tem os dados mínimos.
- Cliente não recebeu o PIX: reenvie o cartão de pagamento na conversa.
- Pago mas continua pendente: confira a configuração do webhook (veja Reembolsos, webhooks e relatórios).
- Recurso indisponível (ex.: cartão): pode ser uma limitação do gateway escolhido — confira a matriz de recursos em Conectar gateway.