## 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

1. Em uma conversa, abra a ação de **criar cobrança** (ou crie pela área de Pagamentos).
2. 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.
3. Selecione o **método de pagamento**: PIX, boleto ou cartão (checkout hospedado).
4. (Opcional) Aplique **desconto** ou ajuste o valor — veja *Descontos e ajuste de valor*.
5. Defina o **vencimento**, quando aplicável.
6. 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.
7. **Envie na conversa**: o cartão de pagamento aparece para o cliente na mesma janela. Em
   pagamentos PIX, o rótulo e o código aparecem separados para facilitar a leitura; mesmo um código
   longo permanece dentro do card. Use a ação de copiar para levar o código completo.
8. Acompanhe o status mudar de pendente para pago automaticamente quando o gateway confirmar.

## Configurações & opções

### Cobrar uma empresa (PJ)

1. Escolha o **contato responsável**. Na conversa, esse contato permanece como contexto do atendimento.
2. Em **Pagador**, escolha **Empresa** e selecione uma empresa vinculada ao contato. Essa escolha é explícita: o vínculo do CRM ou um produto do catálogo não define sozinho quem paga.
3. Confira o cadastro da empresa: razão social e CNPJ, além de e-mail, telefone e endereço exigidos pelo gateway e pelo método. Os dados fiscais do pagador vêm da empresa escolhida; os dados pessoais do contato não substituem esse cadastro.
4. Se a lista estiver carregando ou falhar, aguarde ou use **Tentar novamente**. A plataforma não transforma uma falha de carregamento em ausência de empresas. Empresa sem cadastro obrigatório completo não deve ser faturada como contato para contornar o erro.

A criação em contexto de conversa continua exigindo o contato responsável. Uma assinatura importada ou registrada sem contato não equivale a um fluxo completo de atendimento na conversa. No Asaas, não presuma que alterar a empresa na plataforma sincroniza automaticamente todos os dados de um cliente já existente: confira razão social, e-mail e endereço também no gateway.

### Planos de cobrança e carnê

Um plano de cobrança reúne as parcelas de uma única venda. O total contratado e o valor já recebido são informações diferentes: uma parcela paga não significa que o plano inteiro foi quitado. Cada parcela mantém vencimento, pagamento e histórico próprios.


- **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. No Asaas, quando nenhuma data é informada, o padrão é o dia atual no fuso da conta. A data válida confirmada pelo gateway é guardada na cobrança; confira-a antes de enviar ao pagador.
- **Opções avançadas do Asaas**: multa e juros em percentual e desconto por pagamento antecipado
  podem ser definidos na cobrança; o envio impresso pelos Correios aparece somente para boleto.
  Esse desconto é uma condição de pagamento; ele não substitui o desconto comercial aplicado ao
  valor da cobrança. Deixar um campo **em branco** não envia uma substituição explícita. Confira o padrão da conexão e o painel do gateway. Zero é um valor explícito; confirme o resultado no gateway antes de prometer isenção de multa ou juros.
- **Retorno do Asaas**: informe uma URL HTTPS pública para levar o pagador de volta ao seu site. A
  opção de redirecionamento automático só é enviada quando há uma URL válida.
- **Checkout Mercado Pago**: no cartão hospedado, escolha o limite de parcelas e, se necessário,
  informe URLs HTTPS separadas para pagamento aprovado, recusado e pendente. O retorno automático
  exige a URL de aprovado.
- **Gate por conexão**: a tela mostra somente recursos anunciados pelo gateway escolhido. A API
  também recusa uma opção incompatível; esconder um campo não é a única proteção.
- **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.
- **Dados do pagador automáticos**: quando o pagador é **Pessoa/Contato**, CPF/CNPJ e endereço vêm dos dados nativos do contato
  (o documento já vem preenchido para você conferir; endereço de cobrança tem prioridade sobre o
  principal). Preencha uma vez no contato e nunca mais redigite — veja *Dados fiscais e
  endereço do contato*.

### Ver detalhes e histórico

Na lista de cobranças, clique no cliente para abrir o detalhe — inclusive em cobranças PIX ou
lançadas manualmente, que não possuem uma página hospedada. A ação principal acompanha o que a
cobrança realmente permite: **copiar o código PIX**, **abrir boleto/checkout** ou, quando o Asaas
autorizar e a cobrança estiver aberta, **marcar como paga manualmente** com justificativa.

O histórico mostra os eventos mais recentes primeiro, identifica operador ou sistema/gateway e
exibe a justificativa registrada. Históricos longos são paginados; mudar de página não altera a
cobrança. Use essa linha do tempo para conferir criação, atualização, pagamento, atraso, cancelamento
e estorno sem depender apenas do status atual.

### Pedido nativo do WhatsApp (WhatsApp Pay)

Quando a conexão do gateway está com o pagamento nativo do WhatsApp ligado, a cobrança chega ao cliente
pela API oficial como um **pedido** do WhatsApp, que ele paga sem sair do app. Esse pedido acompanha a
cobrança:

- quando o pagamento é confirmado, a plataforma atualiza o pedido no WhatsApp do cliente, que passa a mostrar
  o selo **pago**;
- quando a cobrança é cancelada antes do pagamento, o pedido passa a **cancelado** e deixa de oferecer o
  pagamento.

A atualização só sai com a janela de atendimento de 24 horas aberta, porque o WhatsApp não aceita esse tipo de
mensagem fora dela. Fora da janela, o cartão da cobrança na conversa continua mostrando o status certo.

O cliente recebe **um** aviso de pagamento, nunca dois: quando o pedido é atualizado para pago, essa atualização
substitui a mensagem de confirmação de pagamento. A mensagem de confirmação sai no lugar dela quando o pedido não
pode ser atualizado (cobrança sem pedido do WhatsApp, conversa pelo WhatsApp Web ou janela fechada) e também
quando a atualização do pedido é recusada pelo WhatsApp. Se o resultado do envio ficar incerto (o WhatsApp não
confirmou se a atualização chegou), a plataforma não manda a mensagem de confirmação, para o cliente não receber o
aviso duas vezes.

Fora da janela de 24 horas, se o template configurado para enviar cobranças for um template de **detalhes do
pedido**, a plataforma preenche o pedido do template com os mesmos itens, valores e formas de pagamento.

## 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

- Se a rede falhar depois do envio, tente novamente pela mesma tela sem fechá-la: a tentativa mantém
  a mesma chave e recupera a cobrança existente em vez de cobrar o cliente duas vezes.
- 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**.
- Use apenas URLs HTTPS públicas nos retornos. Não coloque tokens, senhas ou outros segredos nelas.

## 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*.
- **Trocar a forma de pagamento de uma cobrança pendente**: use **Editar** na lista de cobranças e
  escolha a nova forma em **Forma de pagamento**. No Asaas, o Pix, o boleto ou o link de cartão são
  atualizados, e o código antigo deixa de ser enviado. No Mercado Pago, cancele e crie de novo.
- **A cobrança foi criada, mas não chegou à conversa**: a plataforma avisa quando só o envio falhou.
  Não crie outra cobrança; reenvie a existente pela lista.

## Veja também

- [Visão geral de Pagamentos](/hc/ajuda/articles/payments-overview-pt-br)
- [Conectar gateway: Asaas e Mercado Pago](/hc/ajuda/articles/payments-conectar-gateway-pt-br)
- [Descontos e ajuste de valor](/hc/ajuda/articles/payments-descontos-pt-br)
- [Assinaturas e planos recorrentes](/hc/ajuda/articles/payments-assinaturas-planos-pt-br)
- [Reembolsos, webhooks e relatórios](/hc/ajuda/articles/payments-reembolsos-webhooks-relatorios-pt-br)

- [Planos de cobrança e carnê](/hc/ajuda/articles/payments-planos-de-cobranca-pt-br)