## Visão geral

O módulo de **Pagamentos** transforma a ConversaLabs em um balcão de cobrança dentro do próprio
atendimento. Com ele você conecta um gateway (Asaas ou Mercado Pago), cria cobranças avulsas,
recorrentes ou a partir de um negócio do CRM, e envia o link de pagamento direto na conversa — com
**PIX** (QR Code + copia-e-cola), **boleto** e **cartão** (checkout hospedado).

Tudo acontece sem sair da plataforma: o cliente recebe a cobrança na mesma janela em que conversa
com você, paga, e o status é atualizado automaticamente quando o gateway confirma o pagamento. Você
não precisa entrar no painel do banco para acompanhar — a ConversaLabs reflete pago, vencido,
reembolsado e cancelado em tempo real.

## Pré-requisitos

- O módulo **Pagamentos** precisa estar habilitado para a sua conta. Ele é opcional e vem desativado
  por padrão — peça a um administrador ou ao operador da plataforma para ativá-lo.
- Uma conta ativa em um gateway suportado: **Asaas** ou **Mercado Pago**.
- Permissão de administrador para conectar o gateway e configurar webhooks.
- Para cobrar a partir do CRM ou da Agenda, esses módulos também precisam estar habilitados.

## Passo a passo

1. Garanta que o módulo de Pagamentos esteja habilitado para a conta.
2. Conecte um gateway (Asaas ou Mercado Pago) com suas credenciais e ambiente — veja
   *Conectar gateway*.
3. Crie sua primeira **cobrança** (avulsa, a partir do catálogo ou de um negócio) e envie-a na
   conversa.
4. Acompanhe o status da cobrança: pendente, aguardando pagamento, pago, vencido ou reembolsado.
5. Para receitas recorrentes, configure **assinaturas e planos**.
6. Acompanhe os resultados nos **relatórios** (faturamento, ticket médio, MRR e churn).

## Configurações & opções

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


- **Gateways**: conecte um ou mais gateways; cada conexão tem ambiente (produção ou sandbox) e
  credenciais próprias.
- **Métodos de pagamento**: PIX, boleto e cartão via checkout hospedado. A disponibilidade de cada
  método depende do gateway escolhido.
- **Cobranças**: avulsas, com itens (linhas de cobrança), descontos e ajuste de valor.
- **Assinaturas e planos**: cobrança recorrente delegada ao gateway, espelhada na plataforma.
- **Reembolsos**: total ou parcial, conforme o suporte do gateway.
- **Relatórios**: faturamento por status, por gateway e por moeda, ticket médio, MRR e churn.

### Condições do contato em automações de pagamento

Numa regra de automação disparada por um evento de pagamento (cobrança, assinatura ou plano de
cobrança), além dos campos do pagamento você pode usar os campos do **contato do pagamento** —
e-mail, telefone, tipo de contato, cidade, endereço — e os **atributos personalizados de contato**
(por exemplo, `status_lead`). A regra é sempre conservadora: se o pagamento não tem contato, ou se o
contato não tem valor no atributo, uma condição "diferente de" ou "não contém" **não** é atendida.
Assim, "status_lead diferente de pago" só dispara para quem tem um status preenchido e diferente de
"pago". Para agir quando o campo está vazio, use "não está presente".

## Casos de uso

- Fechar uma venda no WhatsApp e enviar o PIX na hora, com QR Code e copia-e-cola.
- Cobrar um serviço a partir de um **negócio** ganho no CRM, sem redigitar valores.
- Criar uma **assinatura** mensal para um cliente recorrente.
- Aplicar um **desconto** pontual em uma cobrança antes de enviá-la.
- Exigir **pré-pagamento** de uma reserva na Agenda (agendamento pago).

## Dicas, limites e boas práticas

- O módulo só funciona com checkout hospedado — a plataforma **nunca** captura dados de cartão, o
  que mantém você fora do escopo PCI.
- Valores são tratados em unidades maiores (reais, não centavos): R$ 49,90 é `49.90`.
- O **webhook** é a fonte da verdade do status: confie nele, não na tela de "sucesso" do checkout.
- Mantenha as credenciais do gateway atualizadas; tokens expirados interrompem novas cobranças.

## Solução de problemas

- **Não vejo Pagamentos no menu**: o módulo não está habilitado para sua conta ou seu perfil — fale
  com um administrador.
- **Não consigo criar cobrança**: verifique se há um gateway conectado e válido.
- **Status não atualiza**: confira a configuração do webhook na seção *Reembolsos, webhooks e
  relatórios*.

## Veja também

- [Conectar gateway: Asaas e Mercado Pago](/hc/ajuda/articles/payments-conectar-gateway-pt-br)
- [Criar cobrança e enviar na conversa](/hc/ajuda/articles/payments-criar-cobranca-enviar-na-conversa-pt-br)
- [Assinaturas e planos recorrentes](/hc/ajuda/articles/payments-assinaturas-planos-pt-br)
- [Descontos e ajuste de valor](/hc/ajuda/articles/payments-descontos-pt-br)
- [Agendamento pago](/hc/ajuda/articles/payments-agendamento-pago-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)