Pagamentos

Visão geral de Pagamentos

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 - Criar cobrança e enviar na conversa - Assinaturas e planos recorrentes - Descontos e ajuste de valor - Agendamento pago - Reembolsos, webhooks e relatórios - Planos de cobrança e carnê

Conectar gateway: Asaas e Mercado Pago

Visão geral Antes de cobrar qualquer pessoa, você precisa conectar um gateway de pagamento. A ConversaLabs suporta Asaas e Mercado Pago. Cada conexão guarda as credenciais do gateway, define o ambiente (produção ou teste) e registra um webhook — o canal pelo qual o gateway avisa a plataforma quando uma cobrança é paga, vence ou é reembolsada. Você pode ter mais de uma conexão (por exemplo, um Asaas de produção e um Mercado Pago para outro fluxo). Cada cobrança é criada em uma conexão específica. Pré-requisitos - Módulo Pagamentos habilitado e permissão de administrador. - Uma conta no gateway escolhido: - Asaas: chave de API (API Key), obtida no painel do Asaas. - Mercado Pago: Access Token e Client Secret das suas credenciais de aplicação. - Definir o ambiente: produção (cobranças reais) ou sandbox (testes). Passo a passo 1. Abra as configurações de Pagamentos e escolha adicionar uma nova conexão. 2. Selecione o gateway: Asaas ou Mercado Pago. 3. Informe as credenciais: - Asaas: cole a API Key. - Mercado Pago: cole o Access Token (e o segredo de assinatura usado para validar o webhook). 4. Escolha o ambiente: produção ou sandbox. 5. Salve. A plataforma valida as credenciais junto ao gateway. 6. Configure o webhook: a plataforma gera a URL de notificação e o segredo de verificação. Em muitos casos o registro é automático; quando não for, copie a URL informada e cadastre-a no painel do gateway. 7. Faça um teste em sandbox (uma cobrança PIX, por exemplo) e confirme que o status muda sozinho quando o pagamento é simulado. Configurações & opções Planos de cobrança e carnê Ative Pagamentos, conecte um gateway compatível e confira os dados do pagador. As opções disponíveis dependem da conexão, do método e do ciclo. Asaas oferece parcelamento nativo mensal de boleto/Pix; outras periodicidades usam recorrência limitada quando suportadas. Não há integração direta com novos bancos nesta entrega. - Ambiente: produção ou sandbox por conexão. Não misture credenciais de ambientes diferentes. - Webhook: a URL é única por conexão e o gateway autentica cada notificação: - Asaas envia um token próprio no cabeçalho da requisição, comparado de forma segura ao que a plataforma guardou. - Mercado Pago assina cada notificação; a plataforma valida a assinatura antes de processar. - Diagnóstico da última conciliação: a verificação periódica compara cobranças e assinaturas com o gateway para cobrir notificações perdidas. Se algum registro falhar, o cartão da conexão em Configurações → Pagamentos → Conexões permanece em vermelho com a quantidade total e até os três primeiros identificadores externos e motivos. Os demais registros continuam sendo processados; respostas brutas, dados do cliente e credenciais nunca aparecem nesse diagnóstico. - Proteções de entrada: são configurações da conexão, não da importação, e valem também para o que chega por webhook. - Data de corte: nada anterior a ela entra. É o freio que impede um histórico inteiro de aparecer como se fosse de hoje. - Adoção automática de cobranças órfãs: desativada por padrão. Uma cobrança que chega do gateway sem correspondência local só é adotada se você permitir; com "somente a partir da data de corte", uma data ausente ou inválida faz a operação falhar de forma segura em vez de adivinhar. - As duas ficam em Importar histórico → Configurações de ingestão e são salvas na conexão, então a próxima importação e o próximo webhook já as respeitam. - Métodos suportados por gateway: | Recurso | Asaas | Mercado Pago | |---|---|---| | PIX | Sim | Sim | | Boleto | Sim | Sim | | Cartão (checkout hospedado) | Sim | Sim | | Parcelamento no cartão | Sim | Sim | | Assinaturas | Sim | Sim | | Planos reutilizáveis | — | Sim | | Reembolso parcial | Sim | Sim | Certificado da conexão Quando a conexão exigir certificado, use a área de certificado para enviar o arquivo e os dados solicitados. Após salvar, confira titular, emissor, impressão digital e vencimento. A edição apresenta metadados; não devolve chave, certificado ou senha. Os estados são ausente, válido, vencendo e vencido. Renove antes do prazo e confira novamente os metadados; o aviso de expiração ajuda a antecipar essa manutenção. A fundação permite validar essa interface em laboratório com certificado fictício. Isso não habilita um banco novo nem transforma certificado de teste em credencial de produção. Casos de uso - Operador que já usa Asaas conecta a chave e passa a cobrar pelo WhatsApp sem trocar de sistema. - Empresa que vende para a América Latina conecta o Mercado Pago. - Time que quer testar antes de cobrar de verdade usa o ambiente sandbox primeiro. Dicas, limites e boas práticas - Trate as credenciais como segredo: elas são armazenadas de forma cifrada e nunca aparecem de volta na tela depois de salvas. - Use sandbox para validar todo o fluxo antes de ir para produção. - A autenticação do Asaas usa um cabeçalho access_token (não Authorization: Bearer). - O Mercado Pago notifica apenas o identificador do pagamento; a plataforma consulta o gateway para ler o estado completo — isso é normal. Solução de problemas - Credenciais inválidas: confira se copiou a chave/token corretos e se o ambiente bate com o do gateway (token de teste só funciona em sandbox). - Status não atualiza: o webhook não está chegando. Confirme se a URL foi registrada no gateway e se o segredo de verificação corresponde. - Notificação rejeitada (401): assinatura/token do webhook não confere — recadastre o webhook. - A última conciliação teve falhas: anote o identificador e o motivo exibidos no cartão, valide a conexão e o ambiente e confirme se o registro ainda existe no gateway. Uma falha fica visível e não altera silenciosamente o registro local. A próxima verificação substitui o diagnóstico; o alerta desaparece somente depois de uma execução sem falhas. Veja também - Visão geral de Pagamentos - Criar cobrança e enviar na conversa - Reembolsos, webhooks e relatórios - Planos de cobrança e carnê - Página pública de cobrança

Criar cobrança e enviar na conversa

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. - 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 - Conectar gateway: Asaas e Mercado Pago - Descontos e ajuste de valor - Assinaturas e planos recorrentes - Reembolsos, webhooks e relatórios - Planos de cobrança e carnê

Assinaturas e planos recorrentes

Visão geral Para receitas que se repetem (mensalidades, planos de serviço, retainers), use assinaturas. Você define o valor e o ciclo (semanal, mensal, anual, etc.), e o gateway gera as cobranças recorrentes automaticamente. A ConversaLabs espelha cada cobrança gerada e o estado da assinatura (ativa, pausada, cancelada), além de alimentar os indicadores de MRR e churn nos relatórios. Você também pode usar planos locais reutilizáveis: eles guardam conexão, valor, moeda e ciclo para vários assinantes. Ao criar cada assinatura, a plataforma envia a recorrência ao gateway; ter um plano local não significa que uma entidade de plano já exista no painel do gateway. Pré-requisitos - Um gateway conectado que suporte assinaturas (Asaas e Mercado Pago suportam). - Para usar um plano reutilizável, mantenha ativa a conexão vinculada a ele. A moeda do plano deve ser a moeda de liquidação dessa conexão. - Um contato/cliente com dados válidos no gateway. Passo a passo 1. Na área de Pagamentos, escolha criar uma assinatura. 2. Selecione o gateway (a conexão) e o cliente (contato). 3. Defina o valor e o ciclo de cobrança (por exemplo, mensal). 4. Defina a data da próxima cobrança e o método (PIX, boleto ou cartão, conforme o gateway). 5. (Opcional, conforme a conexão) Defina o máximo de cobranças ou uma data final. O ciclo bimestral também aparece quando a conexão o oferece. 6. (Opcional) Selecione um plano local. A conexão, o valor, a moeda e o ciclo são preenchidos e bloqueados para manter a assinatura coerente com o modelo escolhido. 7. Salve. O gateway passa a gerar as cobranças no ciclo definido. 8. Acompanhe cada cobrança gerada e o estado da assinatura na plataforma; o cliente recebe a cobrança normalmente. 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ê O parcelamento nativo mensal emite as parcelas no gateway. A recorrência limitada tem uma quantidade final, mas emite cobranças progressivamente: o cronograma previsto não é um boleto já emitido. O plano de cobrança também é diferente do modelo reutilizável de assinatura disponível em Planos. Em Condições de pagamento, confira os padrões da conexão e ajuste somente o necessário na cobrança. Um campo vazio não envia uma substituição explícita. As configurações de multa e juros da conta Asaas não podem ser consultadas pela API; confira-as no painel do provedor quando necessário. - Ciclo: semanal, quinzenal, mensal, bimestral (Asaas), trimestral, semestral ou anual. A tela mostra apenas os ciclos oferecidos pela conexão. - Limites da recorrência: máximo de cobranças encerra após uma quantidade de ciclos; data final (Asaas) encerra no limite informado e nunca pode ficar antes da primeira cobrança. A data final também pode ser ajustada depois em Editar assinatura; o máximo de cobranças é definido na criação. - Assinatura não é parcelamento: o gateway cobra o valor uma vez em cada ciclo. Para dividir uma compra única em parcelas, use a modalidade de plano de cobrança compatível com o método. - Estado da assinatura: ativa, pausada, cancelada — refletido a partir das notificações do gateway. - Planos locais: crie um modelo uma vez e reutilize-o em várias assinaturas compatíveis. O gateway continua recebendo e executando cada assinatura. - Cancelamento: cancele a assinatura na plataforma; o gateway interrompe as próximas cobranças. - Cobranças geradas: cada ciclo vira uma cobrança espelhada, com seu próprio status. Sem cliente vinculado Uma assinatura que veio do gateway pode chegar sem cliente vinculado: o pagador informado lá não correspondeu com exatidão a nenhum contato desta conta. Ela é registrada assim de propósito, com um selo Sem cliente, em vez de desaparecer — o dinheiro continua visível e o vínculo pode ser feito depois. Use o filtro de vínculo na lista para ver só essas. Enquanto estiver sem cliente, a assinatura não abre negócio, não pontua o lead e não dispara ação que dependa de uma pessoa. Em regras de automação, use a condição Contato vinculado à assinatura com "está presente" para só agir quando houver alguém do outro lado. Corrigir cliente e vínculos 1. Na linha da assinatura, use Corrigir cliente e vínculos quando o contato estiver ausente ou errado. 2. Escolha um contato existente ou proponha um novo com nome e pelo menos e-mail, telefone ou documento. Revise também organização e plano alcançados pela mesma assinatura. 3. Para trocar um vínculo que já está preenchido, confirme a substituição — a plataforma pede essa confirmação explícita para não sobrescrever um vínculo correto por engano. 4. Essa ação nunca muda valor, ciclo, estado, próxima cobrança nem identificador do gateway. Para esses fatos, use Editar assinatura ou corrija na origem. Casos de uso - Mensalidade de um serviço de assinatura. - Plano recorrente de suporte ou consultoria (retainer). - Clube/assinatura de conteúdo com renovação automática. Dicas, limites e boas práticas - Se a rede falhar ao criar, tente novamente sem fechar o formulário: a mesma operação é retomada e uma resposta incerta do gateway nunca dispara outra assinatura às cegas. - A recorrência é delegada ao gateway — ele é quem gera e cobra cada ciclo; a plataforma reflete o resultado. - Use planos locais quando muitos clientes assinam a mesma oferta — fica mais fácil manter conexão, preço, moeda e ciclo consistentes. - O MRR dos relatórios normaliza cada assinatura ativa para um valor mensal equivalente; o churn considera as canceladas no período. - Comunique claramente ao cliente o ciclo e o valor antes de ativar a assinatura. Solução de problemas - A próxima cobrança não foi gerada: confirme o estado da assinatura (pode estar pausada ou cancelada) e a configuração do webhook. - Planos não aparecem: confirme que o plano não está arquivado, que sua conexão está ativa, que suporta assinaturas e que a moeda do plano corresponde à moeda de liquidação. - Cancelei e ainda cobrou: verifique se o cancelamento foi confirmado pelo gateway; o efeito vale para os próximos ciclos. Veja também - Visão geral de Pagamentos - Conectar gateway: Asaas e Mercado Pago - Criar cobrança e enviar na conversa - Descontos e ajuste de valor - Reembolsos, webhooks e relatórios - Planos de cobrança e carnê

Planos de cobrança e carnê

Visão geral 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. Pré-requisitos Ative Pagamentos, conecte um gateway compatível e confira os dados do pagador. As opções disponíveis dependem da conexão, do método e do ciclo. Asaas oferece parcelamento nativo mensal de boleto/Pix; outras periodicidades usam recorrência limitada quando suportadas. Os planos de boleto/Pix e a recorrência limitada só aparecem quando esse fluxo está liberado para a conexão. O cartão de crédito parcelado mensalmente é uma cobrança única que o gateway divide e continua disponível mesmo sem planos de cobrança. Não há integração direta com novos bancos nesta entrega. Passo a passo 1. Abra Nova cobrança em Pagamentos ou na conversa e selecione cliente, conexão e método. 2. Escolha a modalidade parcelada, informe o valor total, a quantidade, o primeiro vencimento e o ciclo disponível. 3. Confira o resumo e as condições antes de criar. 4. Abra o plano para acompanhar as parcelas emitidas e o progresso. 5. Use Baixar carnê para obter o PDF e Enviar carnê na conversa para entregá-lo ao cliente; confira o destinatário antes do envio. 6. No menu de cada parcela, Ver cobrança está sempre disponível. Enviar esta parcela na conversa só aparece para parcelas em aberto (pendente, aguardando pagamento ou vencida). Configurações & opções O parcelamento nativo mensal emite as parcelas no gateway. A recorrência limitada tem uma quantidade final, mas emite cobranças progressivamente: o cronograma previsto não é um boleto já emitido. O plano de cobrança também é diferente do modelo reutilizável de assinatura disponível em Planos. Em Condições de pagamento, confira os padrões da conexão e ajuste somente o necessário na cobrança. Um campo vazio não envia uma substituição explícita. As configurações de multa e juros da conta Asaas não podem ser consultadas pela API; confira-as no painel do provedor quando necessário. No detalhe do plano, configure os avisos de parcela paga e de plano concluído. Por padrão, o aviso de cada parcela paga fica desligado e o de conclusão fica ligado. A escolha vale para esse plano; os canais de e-mail e push continuam sujeitos às preferências de notificação do usuário. Ativar um aviso não dispara novamente os eventos que já ocorreram. Casos de uso Use boleto mensal para uma venda em 12 parcelas. Para um serviço com cobranças trimestrais e fim definido, use a recorrência limitada disponível. Uma assinatura sem limite continua sendo uma cobrança recorrente, sem representar uma venda parcelada com total finito. Dicas, limites e boas práticas O carnê enviado ao cliente é o PDF da plataforma com a marca da conta. O PDF do Asaas serve para conferência interna. Boleto usa linha digitável e código de barras fornecidos pelo gateway. No Pix, cada parcela sai num cartão próprio com o QR e o código Pix copia e cola completo, sem campos de boleto como agência, carteira ou ficha de compensação. Dados ainda não fornecidos pelo gateway não devem ser inventados. O carnê mostra a situação atual de cada parcela. Quando uma parcela é paga, cancelada, estornada ou vence, e quando o plano é cancelado ou concluído, a plataforma gera o carnê de novo automaticamente, em poucos segundos. Parcela paga sai com Paga em e a data; parcela cancelada ou estornada sai com a situação em destaque. Nesses casos o carnê não traz QR, código copia e cola, linha digitável nem código de barras, para o cliente não pagar duas vezes. Enquanto o carnê é atualizado, o plano mostra Atualizando o carnê e o envio aguarda a nova versão; o arquivo anterior continua disponível para download. Um plano cancelado ou concluído não tem mais parcelas a pagar. O carnê continua disponível para consulta, mas Enviar carnê na conversa e Notificações deste plano deixam de aparecer. Cancelar interrompe o que o gateway permite cancelar; arquivar organiza a visualização e não estorna dinheiro. Excluir um parcelamento nativo no Asaas é irreversível. Ao cancelar uma cobrança parcelada no cartão, todas as parcelas ainda em aberto no gateway são canceladas juntas; parcelas já pagas são preservadas. Parcelas liquidadas exigem o fluxo apropriado de reembolso; não as apague para corrigir um recebimento. Solução de problemas Faltam parcelas futuras: em recorrência limitada, consulte o cronograma previsto e aguarde a emissão pelo gateway. O carnê ainda não está disponível: confira o estado da geração e tente novamente após a atualização das parcelas. O carnê mostra uma parcela paga como pendente: aguarde alguns segundos enquanto o plano mostra Atualizando o carnê e baixe o PDF de novo. Se o aviso não sumir, ou disser que não foi possível atualizar, use Gerar carnê de novo no plano; o arquivo anterior continua disponível enquanto isso. Enviar carnê na conversa não aparece: o plano foi cancelado ou concluído, ou o carnê está sendo atualizado. Para cobrar uma parcela específica ainda em aberto, use Enviar esta parcela na conversa no menu da parcela. Método ou ciclo indisponível: escolha uma combinação oferecida pela conexão. Pix recorrente no Mercado Pago não está disponível. Parcelamento neste método ainda não está liberado: a conexão ainda não tem o fluxo de planos liberado para boleto ou Pix. Use a cobrança à vista ou o cartão de crédito parcelado. Parcelas 2 em diante não aparecem na plataforma: no cartão parcelado, a venda fica registrada como uma única cobrança e o gateway controla as parcelas. A conciliação lista essas parcelas como não vinculadas, sem tratá-las como falha. Carnê indisponível num plano de cartão: carnê só existe para boleto e Pix. No cartão, cada parcela tem a própria página de pagamento. Aviso "Teste · pagamento não é real": a cobrança ou o plano foi criado numa conexão de teste (sandbox). Tudo é criado e enviado normalmente, mas o pagamento não movimenta dinheiro. Use a conexão de produção para cobrar clientes de verdade. Total diferente do recebido: confira pagamentos, reembolsos e estornos por parcela. O recebimento cresce conforme cada parcela é liquidada. Veja também - Criar e enviar uma cobrança - Condições de pagamento - Assinaturas e planos

Gerenciar planos e ofertas de pagamento

Visão geral O módulo Pagamentos possui dois catálogos reutilizáveis: - Planos guardam conexão, valor, moeda e ciclo para novas assinaturas. - Ofertas guardam preço, forma de pagamento, tipo e vínculos opcionais com conexão e produto. A tela de Ofertas é administrativa. Ela não aceita uma oferta nem cria uma cobrança sem o contexto de um contato ou de uma compra. Pré-requisitos - O recurso Pagamentos deve estar habilitado na conta. - Tenha ao menos uma conexão Asaas ou Mercado Pago ativa para criar planos. - Para vincular uma oferta, cadastre antes o produto no Catálogo. - Exclusões permanentes exigem permissão de administração de pagamentos. Passo a passo 1. No menu lateral, abra Pagamentos. 2. Acesse Planos ou Ofertas. 3. Use busca, filtros e ordenação para localizar registros. A página e os filtros ficam na URL. 4. Clique em Novo plano ou Nova oferta, preencha os campos e salve. 5. Para retirar um registro de uso, arquive-o. Abra Arquivados para restaurar ou, com a permissão necessária, excluir definitivamente. 6. Para várias linhas, selecione os registros da página e use a barra de ações em massa. Se alguma linha falhar, confira os IDs mostrados e corrija somente essas linhas. 7. Ao criar uma assinatura, selecione o plano opcional. A tela preenche e bloqueia conexão, valor, moeda e ciclo para que a assinatura corresponda ao modelo. 8. Use Exportar CSV para baixar o resultado dos filtros atuais ou, se houver seleção, somente os registros selecionados, inclusive os mantidos ao navegar entre páginas. Configurações & opções Planos O plano é um modelo local; ele não afirma que já exista como entidade no gateway. A recorrência real é criada no gateway somente quando uma assinatura começa. A moeda deve corresponder à moeda de liquidação da conexão, e os ciclos respeitam suas capacidades: por exemplo, o ciclo bimestral aparece apenas quando o gateway o oferece. Ofertas Escolha entre order bump, upsell e downsell. A conexão pode ficar como padrão da conta e o produto é opcional. Ao arquivar uma oferta, ela é desativada; ao restaurar, continua inativa até ser revisada e ativada novamente. Casos de uso - Reutilizar uma mensalidade em várias assinaturas. - Oferecer instalação, suporte prioritário ou um complemento no checkout. - Manter ofertas sazonais inativas sem perder sua configuração. - Separar ofertas por produto, conexão, tipo ou status. Dicas, limites e boas práticas - Confirme a moeda de liquidação da conexão antes de publicar preços. - Arquive antes de excluir definitivamente. A exclusão permanente não pode ser desfeita. - Restaurar uma oferta não a ativa automaticamente; revise preço, produto e conexão primeiro. - Uma ação em massa é processada registro por registro. Resultado parcial é esperado quando alguma linha viola a regra de ciclo de vida. Solução de problemas - O ciclo bimestral não aparece: a conexão selecionada não anuncia essa capacidade. - Uma forma de pagamento não aparece: ela não é suportada pela conexão escolhida. - Não consigo excluir: arquive o registro primeiro e confirme que seu perfil permite exclusão permanente. - A lista ficou vazia após filtrar: use Limpar filtros; o estado também pode ser removido da URL. - A oferta restaurada está inativa: esse é o comportamento seguro. Edite e ative depois de revisar. Veja também - Criar cobranças e enviar na conversa - Assinaturas e planos

Página pública de cobrança

Visão geral A página pública da ConversaLabs apresenta uma cobrança ao pagador, sem exigir acesso ao painel. O link permite consultar os dados daquela cobrança; não concede acesso à conta ou às demais vendas. Pré-requisitos A cobrança precisa estar disponível e ter um link válido. O método deve fornecer os instrumentos necessários. Certificado e credenciais de gateway nunca aparecem ao pagador. Passo a passo 1. Abra o detalhe da cobrança em Pagamentos. 2. Confira valor, vencimento, método e situação. 3. Compartilhe o link da cobrança somente com o destinatário correto. 4. O pagador abre o link e usa os instrumentos apresentados para pagar. 5. Acompanhe a confirmação no painel antes de considerar o recebimento concluído. Configurações & opções A página mostra valor, moeda, vencimento e status. Quando disponíveis, apresenta linha digitável e PDF do boleto ou Pix copia-e-cola e QR. Campos ausentes no gateway não são inventados. A página apenas consulta a cobrança; não cria, cancela ou estorna pagamentos. Casos de uso Envie um acesso simples ao boleto ou ao Pix sem conceder acesso ao painel. Cada parcela de um plano mantém seus próprios dados de pagamento; o carnê reúne as parcelas conforme sua emissão. Dicas, limites e boas práticas O status reflete a última atualização recebida pela plataforma e pode atrasar em relação ao banco. O horário exibido indica a atualização local. Quem possui o link pode consultar a cobrança: evite publicá-lo em grupos ou páginas abertas. Links arquivados, revogados, expirados ou invalidados por privacidade ficam indisponíveis. Solução de problemas Link indisponível: peça ao operador para verificar se a cobrança ainda está disponível. Falta PDF, linha ou QR: confira quais instrumentos o gateway já forneceu. Pagamento realizado, status pendente: aguarde o processamento e confira o recebimento no gateway; reabrir a página não força uma consulta financeira ao banco. Veja também - Gerenciar cobranças - Planos de cobrança e carnê

Descontos e ajuste de valor

Visão geral Você pode reduzir o valor de uma cobrança ou assinatura aplicando descontos. O desconto pode ser por linha de cobrança (em um item específico) ou no total da transação. O valor enviado ao gateway é sempre o valor líquido — ou seja, o subtotal menos o desconto. Os provedores de pagamento não são alterados; eles só recebem o valor final já calculado. Opcionalmente, sua conta pode exigir um motivo ao aplicar desconto, para manter histórico e controle de quem deu qual abatimento. Pré-requisitos - Módulo Pagamentos habilitado e um gateway conectado. - Permissão para criar/editar cobranças e assinaturas. - Se a sua conexão exigir motivo do desconto, tenha a justificativa em mãos. Passo a passo 1. Ao criar (ou editar) uma cobrança ou assinatura, localize o campo de desconto. 2. Escolha onde aplicar: - Por item: informe o desconto na linha de cobrança correspondente. - No total: informe o desconto sobre a soma das linhas. 3. Defina o valor do desconto. 4. Se solicitado, informe o motivo do desconto. 5. Confira o valor final (subtotal − desconto) antes de salvar. 6. Salve e, no caso de cobrança, envie na conversa normalmente. 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. - Desconto por item × desconto no total: combine ambos quando precisar — o total reflete a soma dos abatimentos. - Exigir motivo do desconto: opção por conexão; quando ligada, o desconto só é aceito com justificativa. - Valor líquido: o gateway sempre recebe o valor já com o desconto aplicado; não há cálculo posterior do lado do provedor. - Relatórios: o total de descontos concedidos aparece nos relatórios de Pagamentos. O desconto comercial reduz o total da venda antes da divisão em parcelas. Ele é diferente do desconto por antecipação nas condições do gateway. Confira o total e o resumo de parcelas após aplicar o desconto; uma alteração não deve reescrever parcelas já liquidadas. Casos de uso - Conceder um desconto pontual para fechar uma venda. - Aplicar abatimento em um item específico de uma cobrança com vários produtos. - Oferecer um valor promocional em uma assinatura. - Manter rastreabilidade de quem concedeu cada desconto, exigindo motivo. Dicas, limites e boas práticas - O desconto reduz o valor líquido enviado ao gateway — confira o total antes de enviar. - Padronize os motivos de desconto para facilitar a análise nos relatórios. - Para acompanhar o impacto, use a métrica de descontos concedidos e o ticket médio nos relatórios. - Lembre-se: valores são em unidades maiores (R$ 10,00 = 10.00). Solução de problemas - Não consigo salvar sem motivo: sua conexão exige justificativa — preencha o motivo do desconto. - O total não bateu: confira se há descontos por item e no total ao mesmo tempo; o valor final é o subtotal menos a soma dos descontos. - Desconto não aparece no gateway: o provedor recebe apenas o valor líquido; o detalhamento do desconto fica na plataforma. Veja também - Criar cobrança e enviar na conversa - Assinaturas e planos recorrentes - Reembolsos, webhooks e relatórios - Visão geral de Pagamentos - Planos de cobrança e carnê

Condições de pagamento e simulação do parcelamento

Visão geral Uma cobrança tem mais decisões do que apenas o valor. Condições de pagamento reúne tudo o que muda quanto o cliente paga e quanto a sua empresa recebe: - Multa por atraso — cobrada uma vez, quando a cobrança vence sem pagamento. - Juros ao mês — acumulados enquanto a cobrança permanece vencida. - Desconto por antecipação — abatimento se o cliente pagar antes de uma data. - Parcelamento e quem paga os juros — a empresa absorve o custo, ou o cliente paga. E a simulação responde, antes de cobrar, as duas perguntas que importam: o cliente paga quanto por mês? e você recebe quanto? Pré-requisitos - Uma conexão de gateway ativa em Pagamentos → Configurações. - As condições dependem do gateway. O Asaas aceita multa, juros e desconto por antecipação; o Mercado Pago não expõe esses campos, então eles não aparecem em uma conexão Mercado Pago. - Cartão, boleto e Pix têm modalidades distintas de parcelamento, conforme a conexão. Uma assinatura cobra um valor por ciclo; a recorrência limitada possui uma quantidade final. Passo a passo Definir o padrão da conta 1. Vá em Pagamentos → Configurações → Conexões e edite a conexão. 2. Em Juros do parcelamento, escolha quem paga: - A empresa absorve — o cliente paga o valor da cobrança dividido, e a taxa do gateway sai do seu líquido. É o comportamento padrão. - O cliente paga — as parcelas são acrescidas de juros para que você receba o valor cheio. 3. Escolhendo O cliente paga, informe a taxa mensal. Deixando em branco, usamos a tabela de taxas do próprio gateway — e a dica abaixo do campo mostra a quanto isso equivale ao mês para o parcelamento escolhido, antes de você decidir sobrescrever. 4. Salve. Toda cobrança nova passa a nascer com essa escolha — e cada cobrança pode mudá-la. Aplicar condições em uma cobrança 1. Abra Nova cobrança e escolha a forma de pagamento. 2. No bloco Condições de pagamento, preencha multa, juros e desconto por antecipação. 3. Em multa e desconto, escolha a unidade Percentual ou Valor fixo junto ao campo. 4. Se for cartão de crédito, escolha o número de parcelas. O bloco Simulação aparece logo abaixo. Ler a simulação O bloco mostra duas colunas: - O cliente paga — por exemplo 12x de R$ 83,08 (última de R$ 83,12) e o total. A última parcela carrega o resto da divisão; é assim que o gateway divide o valor. - Você recebe — o líquido depois da taxa do gateway, com a taxa detalhada abaixo. Quando a simulação é confirmada pelo gateway, aparece o selo Confirmado pelo gateway. Configurações & opções Planos de cobrança e carnê O parcelamento nativo mensal emite as parcelas no gateway. A recorrência limitada tem uma quantidade final, mas emite cobranças progressivamente: o cronograma previsto não é um boleto já emitido. O plano de cobrança também é diferente do modelo reutilizável de assinatura disponível em Planos. Em Condições de pagamento, confira os padrões da conexão e ajuste somente o necessário na cobrança. Um campo vazio não envia uma substituição explícita. As configurações de multa e juros da conta Asaas não podem ser consultadas pela API; confira-as no painel do provedor quando necessário. | Condição | Asaas | Mercado Pago | |---|---|---| | Multa por atraso (% ou valor fixo) | Sim | Não | | Juros ao mês | Sim | Não | | Desconto por antecipação | Sim | Não | | As três em assinatura | Sim | Não | | Escolher quem paga os juros do parcelamento | Sim | Não — a empresa sempre absorve | | Máximo de parcelas no cartão | 21 | 36 | | Mostrar o líquido antes do pagamento | Sim | Não | 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. Casos de uso - Serviço recorrente com atraso frequente: multa de 2% + juros de 1% ao mês na assinatura. Toda cobrança gerada pela recorrência herda a política. - Produto de ticket alto: 12x com o cliente paga os juros, para você receber o valor cheio. - Incentivo a pagar antes: desconto de 5% até 3 dias antes do vencimento. - Multa em reais: R$ 10,00 fixos em vez de percentual, em cobranças de valores muito diferentes. Dicas, limites e boas práticas - Uma multa ou desconto em valor fixo nunca pode ser maior que a cobrança. - Um percentual nunca passa de 100. - Se escolher O cliente paga sem taxa mensal e sem a tabela de taxas do gateway disponível, a cobrança é recusada com uma mensagem pedindo a taxa — em vez de cobrar a sua empresa em silêncio. - Ao editar uma cobrança pendente, as condições vão junto para o gateway. Limpar todos os campos remove a política da cobrança. - A simulação é uma estimativa até o selo de confirmação aparecer. Quando o gateway não informa o líquido (Mercado Pago), a tela diz isso — nunca mostramos um número estimado ali. Solução de problemas "Não foi possível calcular a simulação agora." Uma indisponibilidade momentânea do gateway. Use Tentar novamente; a cobrança pode ser criada mesmo assim. "Este gateway não informa o valor líquido antes do pagamento." Esperado no Mercado Pago. O valor que o cliente paga continua correto; o líquido só é conhecido depois da liquidação. "Não conseguimos ler a tabela de taxas desta conta no gateway agora." A leitura da tabela falhou — credencial recusada, instabilidade ou resposta inesperada do gateway. Use Ler as taxas novamente ali mesmo: nada é guardado quando a leitura falha, então o botão consulta o gateway de verdade. Salvar a conexão novamente também força uma nova leitura. As opções de multa e juros não aparecem. A conexão é Mercado Pago, que não oferece esses campos. O campo de parcelas não aparece. Confira a modalidade, o método e os limites oferecidos pela conexão. Veja também - Descontos e ajuste de valor - Criar cobrança e enviar na conversa - Assinaturas e planos - Conectar um gateway - Planos de cobrança e carnê

Agendamento pago

Visão geral O agendamento pago conecta a Agenda ao módulo de Pagamentos: o cliente só confirma uma reserva depois de pagar. Quando alguém agenda um tipo de evento marcado como pago, a plataforma cria uma cobrança automaticamente (por exemplo, um PIX), segura o horário enquanto o pagamento está pendente e confirma a reserva sozinha quando o gateway avisa que foi pago. É ideal para consultas, sessões e serviços em que você quer garantir o compromisso do cliente com um pré-pagamento — reduzindo faltas e no-shows. Pré-requisitos - Módulos Agenda e Pagamentos habilitados. - Um gateway conectado e válido. - Um tipo de evento (na Agenda) configurado para cobrar — com valor e modo de pagamento. Passo a passo 1. Na Agenda, abra o tipo de evento que deve exigir pagamento. 2. Defina o modo de pagamento do tipo de evento (por exemplo, pagamento único para liberar a reserva). 3. Informe o valor da reserva e o método (PIX, boleto ou cartão, conforme o gateway). 4. Salve o tipo de evento. 5. Quando um cliente agendar esse tipo de evento, a plataforma cria a cobrança e deixa a reserva aguardando pagamento. 6. O cliente paga; o gateway notifica e a reserva passa a confirmada automaticamente. 7. Acompanhe tanto a cobrança (em Pagamentos) quanto a reserva (na Agenda). Configurações & opções - Modo de pagamento por tipo de evento: definido na Agenda (por exemplo, pré-pagamento obrigatório). - Reserva aguardando pagamento: o horário fica reservado/retido até a confirmação; reservas não pagas podem expirar conforme a regra configurada. - Confirmação automática: a reserva vira confirmada ao receber o evento de pagamento do gateway — sem ação manual. - Método de cobrança: PIX, boleto ou cartão, conforme o gateway conectado. Casos de uso - Consultório que exige pagamento antecipado de consultas. - Profissional que cobra sinal/entrada para reservar um horário. - Serviços com alta demanda em que o pré-pagamento garante o compromisso. Dicas, limites e boas práticas - Use PIX para liberar a reserva mais rápido (confirmação quase imediata). - Deixe claro na descrição do tipo de evento que o horário só é confirmado após o pagamento. - Defina um prazo razoável para a reserva pendente, evitando segurar horários por tempo demais. - A confirmação depende do webhook do gateway; mantenha-o configurado corretamente. Solução de problemas - A reserva não confirma após o pagamento: verifique o webhook do gateway (veja Reembolsos, webhooks e relatórios). - Não aparece a opção de cobrar no tipo de evento: confirme que os módulos Agenda e Pagamentos estão habilitados e que há um gateway conectado. - O horário foi liberado sem pagamento: revise o modo de pagamento do tipo de evento (deve exigir pré-pagamento). Veja também - Visão geral de Pagamentos - Criar cobrança e enviar na conversa - Assinaturas e planos recorrentes - Reembolsos, webhooks e relatórios

Importar histórico do gateway com segurança

Visão geral A importação de histórico traz para a ConversaLabs cobranças, vínculos de clientes e assinaturas que já existem no gateway. Cobranças criam os eventos financeiros, Pedidos e relatórios; assinaturas passam a aparecer em Pagamentos > Assinaturas; e um cliente importado só cria o vínculo técnico com um contato que já exista na conta. O processo é governado: uma prévia não grava cobranças, vínculos nem assinaturas; ela persiste somente a execução auditável e a captura usada para revisar a seleção. Uma importação real só inclui os registros que você selecionar. A plataforma nunca cria contatos ou empresas silenciosamente: uma cobrança sem correspondência exata fica bloqueada até você escolher um contato existente ou propor um novo, que só será criado depois da confirmação final. Quando a cobrança e a assinatura têm o mesmo identificador de assinatura do gateway, elas também são vinculadas entre si, mesmo que você importe uma antes da outra. Cobranças históricas não disparam mensagens ao cliente, conversões de anúncios, comissões nem webhooks de saída. Pré-requisitos - Você precisa ser administrador da conta. - A conexão do Asaas ou Mercado Pago deve estar ativa e com as credenciais verificadas. - Para cobranças do Mercado Pago, escolha uma data inicial dentro dos últimos 12 meses. A busca completa desse recurso segue essa janela móvel. - Para clientes do Mercado Pago, informe o e-mail do cliente. A API documentada desse gateway não oferece uma varredura total de clientes. - Revise a data de corte antes de permitir adoção automática de cobranças desconhecidas por webhook. Passo a passo 1. Acesse Configurações > Pagamentos > Conexões e escolha Importar histórico na conexão desejada. Você também pode abrir a ação no estado vazio de Cobranças. 2. Em Recurso para importar, escolha Cobranças, Vínculos de clientes ou Assinaturas. As proteções de entrada e a adoção automática se aplicam somente às cobranças. 3. Para cobranças, defina a data de corte e mantenha a adoção automática desativada, a menos que sua operação tenha uma regra clara. A opção “Somente a partir da data de corte” exige uma data válida. 4. Informe o período e o limite de registros. Para cliente do Mercado Pago, informe também o e-mail. Selecione Gerar prévia. 5. Revise a lista detalhada. Cada cobrança mostra os dados de cliente que o gateway forneceu, o contato encontrado e o sinal exato usado na associação. Busque por identificador, referência ou cliente; combine filtros; altere a ordenação e percorra as páginas sem perder a seleção já feita em outras páginas. 6. Em uma cobrança marcada como Cliente pendente, escolha um contato existente ou proponha um novo com nome e pelo menos um identificador (e-mail, telefone ou documento). A proposta não cria nada durante a prévia. Correspondências automáticas usam somente cliente do gateway, e-mail, telefone normalizado ou documento exatos; nomes parecidos nunca bastam. 7. Use Selecionar importáveis desta página, Selecionar todos os importáveis destes filtros (quando a prévia passa de uma página) ou marque cada linha. A seleção global considera todas as páginas do recorte, mas alcança apenas registros importáveis e com cliente resolvido: uma linha ignorada, já sincronizada ou pendente nunca é marcada. Alterar um filtro limpa a seleção de propósito; mudar de página a preserva. A conexão, a execução, os filtros e a ordenação ficam na URL, por isso voltar, avançar ou reabrir o link restaura a mesma visão somente quando a conexão pertence à conta atual. 8. Selecione Importar selecionados, confira a quantidade e as resoluções de cliente na confirmação e confirme. Uma seleção vazia nunca significa “importar tudo”. Contatos propostos são criados dentro da importação confirmada; se qualquer validação falhar, a cobrança correspondente não entra sem contato. 9. Acompanhe o resultado e o histórico da conexão. Registros com falha mostram o identificador e o motivo; o sucesso nunca inclui uma linha que falhou. Configurações & opções Data de corte e adoção automática A data de corte limita a entrada de histórico. A adoção automática de cobranças que chegarem por webhook fica desativada por padrão. Se você a habilitar a partir da data de corte, a plataforma falha de forma segura quando a data estiver ausente ou inválida. Lista da prévia A prévia é uma captura segura da mesma execução que importaria os dados, sem gravar cobranças, vínculos ou assinaturas. A lista usa paginação e totais retornados pelo servidor; o contador não é calculado apenas com a página visível. Em telas pequenas, os filtros e a ordenação abrem em um painel próprio e cada linha vira um cartão legível. Os chips mostram os filtros ativos. Limpar filtros aparece quando uma combinação não encontra resultados. Se o limite informado for atingido, a prévia avisa que foi truncada: gere outra janela em vez de presumir que todo o histórico foi lido. Registros ignorados Na prévia, use o ícone de bloqueio ao lado de um registro para ignorá-lo permanentemente e informe o motivo. A decisão é separada por cobrança, cliente ou assinatura, mesmo se o gateway reutilizar um identificador. Em Registros ignorados permanentemente, use Permitir novamente para desfazer essa decisão. Vínculos com contatos e empresas A plataforma procura primeiro correspondências exatas por cliente do gateway, e-mail, telefone normalizado, documento e CNPJ. Para uma cobrança sem contato, você precisa escolher manualmente um contato da conta ou propor a criação de um novo antes de selecioná-la. A criação é adiada até a confirmação e o vínculo manual nunca é substituído silenciosamente. Uma assinatura sem contato correspondente continua visível para futura conciliação; um cliente do diretório sem contato correspondente é ignorado, porque não há proprietário local seguro para o vínculo. Cobranças e assinaturas são conectadas somente pelo identificador exato que o gateway informa, nunca por valor, data ou nome. Casos de uso - Recuperar cobranças, Pedidos e assinaturas depois de conectar um gateway que já tinha vendas. - Construir primeiro os vínculos de clientes do Asaas e depois importar assinaturas, para aumentar a associação pelo identificador exato do gateway. - Reconstruir relatórios internos sem reenviar notificações para clientes antigos. - Excluir de forma durável uma cobrança que pertence a outra operação ou que não representa uma venda. - Importar primeiro um período pequeno, validar os resultados e repetir em janelas menores. Dicas, limites e boas práticas - Comece com uma janela curta e um limite baixo; amplie somente após conferir a prévia. - Cada prévia/importação e cada seleção explícita aceitam no máximo 5.000 registros. - A importação confirmada deve usar exatamente o mesmo tipo de recurso, período, limite e e-mail da prévia concluída. Se qualquer parâmetro mudar, gere uma nova prévia; isso vale para cobranças, clientes e assinaturas. - A seleção é obrigatória. A plataforma nunca interpreta uma seleção vazia como “importar tudo”. - A seleção sobrevive à paginação e Selecionar todos cobre todas as páginas dos filtros atuais, mas ela é limpa ao mudar busca ou filtros para impedir que uma linha invisível seja importada por engano. - Cobranças sem contato resolvido não podem ser selecionadas. Resolva cada uma manualmente; a API também bloqueia tentativas de contornar a prévia. - A lista de registros ignorados é carregada por completo em páginas internas; mais de 100 exclusões não desaparecem silenciosamente. - Clientes não usam filtro de data; eles só podem vincular um contato já existente. No Mercado Pago, a busca é sempre por e-mail. - Os totais são mostrados por moeda; não compare a soma de moedas diferentes como se fosse um único valor. - A reversão remove apenas registros locais que aquela execução criou. Ela nunca altera o gateway. - Para reverter, abra uma execução elegível no histórico, digite undo e confirme. Se uma cobrança, vínculo de cliente, assinatura, Pedido ou evento posterior tiver movimentado os dados, a reversão é recusada inteira para preservar a auditoria. A reversão remove somente registros e vínculos criados pela execução; contatos e organizações são preservados, inclusive um contato proposto e confirmado manualmente. - Execuções antigas, feitas antes da trilha de reversão, podem não ser elegíveis. Nesse caso, mantenha o histórico e faça os ajustes financeiros pela operação normal. Solução de problemas Mercado Pago pede uma data inicial Informe uma data dentro da janela de histórico suportada pelo Mercado Pago. Uma data anterior pode produzir uma visão incompleta e é recusada pela plataforma. Não consigo importar sem selecionar registros Isso é esperado. Gere a prévia, marque os registros desejados e execute a importação selecionada. Uma cobrança não pode ser selecionada porque o cliente está pendente Abra a resolução de cliente na própria linha. Escolha um contato existente ou proponha um novo com nome e e-mail, telefone ou documento. Depois de salvar a decisão, selecione a cobrança e confirme a importação. O contato novo ainda não existe até essa confirmação. O Mercado Pago pede o e-mail do cliente Isso é esperado. A busca documentada de clientes do Mercado Pago exige e-mail e não permite uma importação geral da agenda. Informe o e-mail do cliente existente que deseja vincular ou importe assinaturas, que tentam associar os dados de pagador fornecidos pelo gateway. Uma cobrança aparece como ignorada Abra Cobranças ignoradas permanentemente na mesma tela, confirme o motivo e use Permitir novamente se ela puder voltar a ser considerada. A reversão foi recusada Ocorreu movimentação posterior ou o registro não foi criado pela execução escolhida. Nenhum dado foi removido. Revise a linha do histórico, os eventos da cobrança e faça o ajuste apropriado pela operação financeira normal. Veja também - Conectar um gateway de pagamentos - Gerenciar cobranças - Reembolsos, webhooks e relatórios

Reembolsos, webhooks e relatórios

Visão geral Este artigo cobre o que acontece depois que a cobrança é enviada: como devolver dinheiro (reembolso), como o webhook mantém os status sincronizados sem você fazer nada e quais relatórios mostram a saúde financeira da operação. O webhook é o canal pelo qual o gateway avisa a plataforma a cada mudança (pago, vencido, reembolsado, cancelado). Por isso ele é a fonte da verdade: a plataforma atualiza o status da cobrança a partir do webhook, não da tela de "sucesso" do checkout. Pré-requisitos - Módulo Pagamentos habilitado e um gateway conectado com webhook configurado. - Permissão para emitir reembolsos. - Para os relatórios, ter cobranças/assinaturas registradas no período. Passo a passo Reembolsar uma cobrança 1. Abra a cobrança que deseja reembolsar (já paga). 2. Escolha reembolsar. 3. Selecione total (devolve o valor inteiro) ou parcial (informe o valor a devolver). 4. Confirme. A plataforma solicita o reembolso ao gateway. 5. Acompanhe o status mudar para reembolsado (ou parcialmente reembolsado) quando o gateway confirmar. Verificar o webhook 1. Nas configurações da conexão do gateway, confira a URL do webhook e o segredo de verificação. 2. Garanta que a URL esteja registrada no painel do gateway. 3. Faça um teste e veja o status atualizar automaticamente. Ler os relatórios 1. Abra os relatórios de Pagamentos. 2. Filtre por período. 3. Analise os indicadores (faturamento, ticket médio, MRR, churn) e os recortes por status, gateway e moeda. Configurações & opções Planos de cobrança e carnê Faltam parcelas futuras: em recorrência limitada, consulte o cronograma previsto e aguarde a emissão pelo gateway. O carnê ainda não está disponível: confira o estado da geração e tente novamente após a atualização das parcelas. Método ou ciclo indisponível: escolha uma combinação oferecida pela conexão. Pix recorrente no Mercado Pago não está disponível. Total diferente do recebido: confira pagamentos, reembolsos e estornos por parcela. O recebimento cresce conforme cada parcela é liquidada. - Reembolso total × parcial: ambos suportados pelos gateways atuais. - Webhook: autenticado por cada gateway (token no cabeçalho no Asaas; assinatura no Mercado Pago); notificações repetidas são tratadas com segurança (sem duplicar efeitos). - Indicadores dos relatórios: | Indicador | O que mostra | |---|---| | Faturamento | Total recebido no período | | Ticket médio | Valor médio por cobrança paga | | Descontos concedidos | Soma dos descontos aplicados | | Por status | Distribuição entre pago, pendente, vencido, etc. | | Por gateway | Quanto entrou por Asaas / Mercado Pago | | Por moeda | Recortes quando há mais de uma moeda | | MRR | Receita recorrente mensal das assinaturas ativas | | Churn | Assinaturas canceladas no período | Casos de uso - Devolver um valor a um cliente que desistiu (reembolso total). - Estornar parte de uma cobrança (reembolso parcial). - Acompanhar o crescimento de receita recorrente pelo MRR. - Identificar perda de assinantes pelo churn. Dicas, limites e boas práticas - Sempre confie no webhook para o status; a tela do checkout pode renderizar antes da confirmação. - O reembolso é processado pelo gateway — o prazo de devolução ao cliente segue as regras do provedor/meio de pagamento. - Acompanhe MRR e churn juntos para ter a foto real da recorrência. - Mantenha a URL do webhook acessível e o segredo de verificação correto; sem isso, os status não atualizam. Solução de problemas - Status nunca muda para pago: o webhook não está chegando ou foi rejeitado (assinatura/token incorretos) — reconfigure o webhook na conexão. - Reembolso não conclui: confirme que a cobrança estava paga e que o gateway suporta o tipo de reembolso solicitado. - Relatório vazio: verifique o filtro de período e se há cobranças no intervalo. - MRR parece incorreto: confirme os ciclos das assinaturas; o MRR normaliza cada uma para o equivalente mensal. Veja também - Visão geral de Pagamentos - Conectar gateway: Asaas e Mercado Pago - Criar cobrança e enviar na conversa - Assinaturas e planos recorrentes - Descontos e ajuste de valor - Planos de cobrança e carnê

Configurar as mensagens de pagamento

Visão geral Os pagamentos enviam duas mensagens ao cliente: a cobrança e a confirmação de pagamento. Aqui você personaliza o corpo de cada uma por idioma, sem depender de IA. O que não personalizar continua usando a mensagem embutida da ConversaLabs. Além do corpo, você edita os rótulos auxiliares da cobrança (legendas, textos de botão, as linhas de valor e vencimento e as instruções de copiar o código) e configura, para cada tipo de mensagem e cada idioma, o modelo aprovado do WhatsApp usado quando a janela de 24h está fechada. Pré-requisitos - Pagamentos habilitado na conta e permissão de administrador. - Para configurar o envio fora da janela: uma caixa de entrada de WhatsApp Cloud com modelos aprovados na Meta. Passo a passo 1. Abra Configurações → Pagamentos → Mensagens. 2. Escolha o idioma no seletor do topo. Ele abre no idioma da conta e lista todos os idiomas habilitados na instalação (até 40), mostrando quantos já têm texto seu ("N de M idiomas com conteúdo"). 3. Escreva o corpo da cobrança e da confirmação em Markdown. Vazio = mensagem padrão do idioma (selo Padrão). 4. Use as variáveis ({x}) para inserir dados do contato, da conta e da própria cobrança. O seletor oferece apenas as variáveis que realmente resolvem naquela mensagem. 5. Abra o bloco Rótulos auxiliares para ajustar os 12 rótulos da cobrança. 6. O bloco Fora da janela de 24h (WhatsApp Cloud) aparece aberto, logo abaixo de cada tipo de mensagem. Escolha o modelo aprovado daquele tipo naquele idioma, mapeie os parâmetros {{1}}, {{2}}… e preencha o botão de link, se houver. Se ainda não houver um modelo, use Criar a partir do meu texto para gerá-lo a partir do corpo que você escreveu. 7. Confira a prévia por canal, use Enviar teste se quiser validar numa conversa real e clique em Salvar mensagens — inclusive depois de criar um modelo, porque criar o modelo não grava a configuração. Restaurar padrão remove a personalização no servidor, não só na tela. Configurações & opções Planos de cobrança e carnê O carnê enviado ao cliente é o PDF da plataforma com a marca da conta. O PDF do Asaas serve para conferência interna. Boleto usa linha digitável e código de barras fornecidos pelo gateway; Pix usa QR e código copia e cola, sem linha digitável de boleto. Dados ainda não fornecidos pelo gateway não devem ser inventados. Cancelar interrompe o que o gateway permite cancelar; arquivar organiza a visualização e não estorna dinheiro. Excluir um parcelamento nativo no Asaas é irreversível. Parcelas liquidadas exigem o fluxo apropriado de reembolso; não as apague para corrigir um recebimento. Idiomas e fallback O idioma é um seletor com todos os idiomas habilitados na instalação. No envio, a ConversaLabs procura o texto nesta ordem: idioma do contato → mesmo idioma-base (pt_BR ↔ pt) → idioma da conta → mensagem padrão embutida. Rótulos auxiliares São 12 rótulos: legendas, textos de botão, as linhas de valor e vencimento e as instruções de copiar o código. Ficam num bloco recolhível e seguem as mesmas regras de idioma e de restauração do corpo. Título dos botões (opcional) Você pode escrever um título que aparece acima da mensagem com botões no WhatsApp Web. Deixe vazio para enviar sem cabeçalho — a plataforma não acrescenta texto genérico. O limite é de 60 bytes (acentos e emojis contam mais de um); um título maior não é salvo. O título pode ser diferente por idioma e não aparece na prévia do corpo. Confirmação de pagamento: o que o corpo substitui O corpo da confirmação substitui só a linha de título ("Pagamento confirmado ✅"). Numa cobrança avulsa, a linha Valor pago continua saindo logo abaixo e é editada em Rótulos auxiliares, não no corpo. Na parcela de um plano de cobrança, o seu corpo abre a mensagem e a linha de baixo informa qual parcela foi recebida (por exemplo, "Recebemos a parcela 2/6"). Com o corpo vazio, a parcela recebe só essa linha padrão. Fora da janela de 24h, vale o modelo aprovado, como antes. Fora da janela de 24h (WhatsApp Cloud) O bloco aparece aberto e embutido logo abaixo de cada tipo de mensagem — não é uma seção que você precisa expandir. O modelo é por tipo de mensagem e por idioma — cobrança e confirmação têm o seu, em vez de um único modelo para o módulo inteiro. Nele você tem: - Escolher o modelo aprovado entre os do catálogo. - Sincronizar da Meta e Criar a partir do meu texto ficam sempre visíveis. Quando a ação não está disponível, o botão aparece desabilitado com o motivo escrito ao lado: a caixa não é WhatsApp Cloud, a conta não tem o WhatsApp Inbox Suite, ou o seu perfil não gerencia caixas de entrada. - Sincronizar da Meta atualiza a lista de modelos aprovados. - Criar a partir do meu texto gera o modelo a partir do texto daquele tipo naquele idioma, enviando-o à Meta como modelo UTILITY, convertendo cada {{ variável }} em {{1}}, {{2}}… e já deixando o mapeamento pronto. Sem texto para gerar, o botão fica desabilitado e a tela pede para escrever o texto primeiro. - Depois do envio, o modelo ainda não está aprovado: ele aparece no seletor marcado como aguardando aprovação e só passa a entregar quando a Meta aprovar e você sincronizar. Enviar de novo com o mesmo nome substitui o rascunho pendente, em vez de falhar. - Criar o modelo não salva a configuração — clique em Salvar mensagens para gravar o mapeamento. - Mapeamento dos parâmetros {{n}} e o campo do botão de link. - Entrega: escolhe de qual caixa do WhatsApp o catálogo de modelos aprovados é consultado. O envio continua saindo pela caixa da própria conversa. Modelos cujo cabeçalho exige mídia ou uma variável não entram nesta lista — este envio não tem como preencher esse cabeçalho — e a tela informa quantos ficaram de fora. Eles continuam utilizáveis pela aba Modelos da própria caixa de entrada, com link direto a partir desta tela. Observações: WhatsApp Web (WazMeow) não tem janela de 24h (o bloco nem aparece); 360dialog pode selecionar um modelo, mas não criar; a Meta casa nome + idioma + aprovado, então um modelo no idioma errado é sinalizado na tela e seria recusado no envio. Prévia e envio de teste A prévia é renderizada no servidor, por canal, e mostra só os canais que a conta realmente tem. Também exibe o modelo resolvido para fora da janela, com os valores que cada parâmetro vai carregar. O Enviar teste manda a mensagem para uma conversa escolhida respeitando a janela de 24h: com a janela fechada e sem modelo configurado, o teste é pulado com o motivo escrito na tela. Variáveis de pagamento Além de contato, conta, conversa, caixa de entrada, agente, CRM e organização — que agora renderizam de verdade —, estas mensagens oferecem os dados da cobrança: | Variável | Substituída por | |---|---| | {{ payment.amount }} | Valor da cobrança | | {{ payment.currency }} | Moeda | | {{ payment.description }} | Descrição da cobrança | | {{ payment.status }} | Situação atual | | {{ payment.due_date }} | Data de vencimento | | {{ payment.billing_type }} | Forma de cobrança (PIX, boleto, cartão…) | | {{ payment.pay_url }} | Link de pagamento | | {{ payment.pix_payload }} | PIX copia e cola | | {{ payment.boleto_url }} | Link do boleto | | {{ payment.boleto_line }} | Linha digitável do boleto | | {{ payment.gateway }} | Gateway usado | Casos de uso - Avisar uma pessoa sobre uma cobrança pendente com um link e uma orientação segura para concluir o pagamento. Dicas, limites e boas práticas - Markdown por canal: anexos somem em LINE/TikTok/X; HTML some no e-mail/widget; *negrito* no WhatsApp vira um par de asteriscos. - Configure o modelo fora da janela no mesmo idioma do corpo — são pares, não uma configuração única. - Ofereça sempre um caminho de pagamento no texto: {{ payment.pay_url }}, {{ payment.pix_payload }} ou {{ payment.boleto_line }}, conforme a forma de cobrança. - Depois de "Criar a partir do meu texto", o modelo fica aguardando aprovação na Meta — use Sincronizar da Meta para ver quando ele for aprovado e passar a entregar. Solução de problemas - Saiu no padrão: o tipo estava vazio (selo Padrão) naquele idioma, ou o idioma do contato não tem texto e o fallback chegou ao padrão embutido. - Fora da janela não enviou: confirme o modelo aprovado daquele tipo naquele idioma. - O modelo aparece sinalizado: está num idioma diferente do da mensagem — troque por um aprovado no idioma certo. - "Criar a partir do meu texto" está desabilitado: o motivo aparece escrito ao lado do botão — a caixa não é WhatsApp Cloud (em 360dialog você escolhe um modelo já aprovado), a conta não tem o WhatsApp Inbox Suite, seu perfil não gerencia caixas de entrada, ou não há texto naquele tipo e idioma para gerar o modelo. - Criei o modelo, mas ele não aparece / não é usado: logo após o envio ele fica aguardando aprovação — só entrega depois que a Meta aprovar e você usar Sincronizar da Meta. E confirme que clicou em Salvar mensagens: criar o modelo não grava a configuração. - Não encontro um modelo na lista: modelos com cabeçalho de mídia ou com variável no cabeçalho não são listados aqui; use-os pela aba Modelos da própria caixa de entrada. - O envio de teste foi pulado: a conversa estava fora da janela de 24h e a mensagem não tinha modelo configurado — a tela informa o motivo. Veja também - Conectar gateways de pagamento (Asaas / Mercado Pago) - WhatsApp Inbox Suite: Templates, Flows e Chamadas - Planos de cobrança e carnê

Gerenciar e conciliar cobranças

Visão geral A área de Cobranças é onde você acompanha e administra tudo o que foi cobrado. Ela tem uma lista pesquisável e paginada (busca, período de criação, status, gateway/conexão, ordenação e uma alternância para mostrar as arquivadas), ações por linha em cada cobrança (ver, editar, corrigir cliente e vínculos, enviar na conversa, reembolsar, marcar como pago, cancelar, arquivar, restaurar, excluir) e uma barra flutuante de ações em lote que aparece quando você seleciona várias cobranças de uma vez. O objetivo é a conciliação: deixar o status de cada cobrança coerente com a realidade — refletindo o que o gateway confirmou e também os pagamentos recebidos por fora da plataforma. Pré-requisitos - Módulo Pagamentos habilitado e ao menos um gateway conectado (veja Conectar gateway). - Cobranças já criadas (veja Criar cobrança e enviar na conversa). - Para excluir definitivamente e para as ações em lote financeiras, é necessária permissão de administrador. Passo a passo 1. Filtrar e abrir uma cobrança 1. Abra a área de Pagamentos → Cobranças. 2. Pesquise por descrição, identificador do gateway/referência externa, nome/e-mail do cliente ou nome da conexão. Combine com status, conexão e o período de criação no fuso da conta. 3. Ordene por criação, vencimento, valor, status ou descrição; ative arquivadas para ver a lixeira. Cada controle ativo aparece como um marcador removível, e a URL preserva página, filtros e ordenação para voltar ou compartilhar a mesma visão. 4. Clique na cobrança para abrir os detalhes. A ação principal respeita o artefato disponível: página hospedada, boleto ou PIX copia e cola — uma cobrança manual continua auditável mesmo sem link. O endereço passa a incluir a cobrança aberta: você pode chegar por um atalho de Pedido ou Comissão, recarregar ou compartilhar o detalhe e, ao fechar, continuar com os filtros anteriores. 5. Use Exportar CSV para baixar todo o recorte filtrado, sem limitar à página visível. Se houver cobranças selecionadas, o arquivo contém somente essa seleção. Em telas pequenas, os filtros ficam no painel Filtros e cada cobrança vira um cartão legível, sem tabela horizontal. 2. Ver a linha do tempo de status (auditoria) 1. Nos detalhes da cobrança, abra a aba de linha do tempo. 2. Cada evento (criada, paga, reembolsada, cancelada, atualizada) é registrado de forma imutável, com o agente responsável, o horário e a justificativa informada — é o histórico financeiro auditável da cobrança. 3. Corrigir cliente e vínculos sem editar os fatos financeiros 1. Na linha ou nos detalhes, use Corrigir cliente e vínculos da venda quando o contato estiver ausente ou errado, inclusive em uma cobrança paga que não pode mais ser editada. 2. Escolha um contato existente ou proponha um novo com nome e pelo menos e-mail, telefone ou documento. Revise também pedido, recuperação, organização, negócio e conversa alcançados pela mesma venda. 3. Gere a prévia e confira conflitos, histórico e eventual impacto em vendedor/afiliado. Alterações de crédito ou comissão exigem confirmação explícita. A aplicação é transacional e auditada. 4. Essa ação nunca muda valor, status, liquidação, vencimento nem identificador do gateway. Para esses fatos, use a operação financeira correspondente ou corrija a origem. 4. Marcar como pago manualmente (e desfazer) 1. Para um pagamento recebido por fora (dinheiro, PIX direto na conta), use Marcar como pago. 2. Informe a justificativa (obrigatória) — ela fica gravada no evento de auditoria. 3. A cobrança passa a paga. Disponível apenas para cobranças ainda em aberto (pendente, aguardando pagamento ou vencida) e em gateways que suportam baixa manual. 4. Para reverter, use Desfazer baixa manual — só funciona em uma cobrança que você mesmo liquidou manualmente; ela volta para pendente/vencida. A justificativa também é obrigatória. 5. Quando o registro de pedidos está habilitado, a cobrança atualiza automaticamente o pedido vinculado. O pedido vindo do gateway preserva o histórico e deve ser gerenciado pela cobrança de origem. Em cartão, a cobrança pode permanecer confirmada enquanto o pedido já aparece como pago: isso significa que o cliente concluiu o pagamento e o saldo ainda aguarda disponibilidade no gateway. 5. Cancelar (em aberto) × reembolsar (paga) 1. Use Cancelar cobrança quando a cobrança ainda estiver em aberto (não paga): o cliente não conseguirá mais pagá-la. 2. Use Reembolsar quando a cobrança já estiver paga: escolha total (devolve tudo) ou parcial (informe o valor). Você pode reembolsar parcialmente mais de uma vez, até o total. 3. O reembolso parcial mantém no pedido e nos relatórios somente a receita líquida restante; o total reverte a receita integral. Em ambos é possível registrar um motivo, que fica na auditoria. 6. Reenviar na conversa 1. Use Enviar para a conversa e informe a conversa de destino. 2. O cartão de pagamento volta a aparecer para o cliente na própria janela do atendimento. 7. Arquivar → restaurar → excluir definitivamente 1. Arquivar tira a cobrança da lista padrão sem apagá-la (vai para a lixeira de arquivadas). 2. Restaurar traz a cobrança arquivada de volta para a lista ativa. 3. Excluir definitivamente apaga de vez — só é permitido em cobranças arquivadas e não liquidadas; cobranças pagas/reembolsadas são mantidas para auditoria e nunca podem ser apagadas. 8. Ações em lote 1. Selecione várias cobranças; a barra flutuante aparece com a contagem. 2. Na lista ativa (admin): marcar como pago, cancelar e reembolsar (apenas total), além de arquivar. 3. Na lista de arquivadas: restaurar e excluir definitivamente (admin). 4. Todas as ações em lote são best-effort: o resultado informa quantas foram processadas e lista os IDs que falharam. Somente as falhas continuam selecionadas para revisão ou nova tentativa; nenhum item pedido desaparece silenciosamente do resultado. 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. - Ação por linha × em lote: a mesma operação existe individualmente em cada cobrança e em lote sobre a seleção. - Permissões: excluir definitivamente e as ações financeiras em lote (marcar como pago, reembolsar, cancelar) e a exclusão em lote são restritas a administradores. - Reembolso em lote = só total: o reembolso parcial existe apenas como ação por linha. - Excluir exige arquivar antes: a exclusão permanente é sempre uma ação deliberada em duas etapas (arquivar e só então excluir). - Exportação: respeita busca, período, filtros e a seleção corrente; dados textuais são protegidos para não serem interpretados como fórmulas pela planilha. - Editar × corrigir vínculos: editar continua sujeito ao status e às regras do gateway. Corrigir vínculos é uma operação separada, inclusive para liquidadas, e atua somente nas associações da venda. Agendamento local e estado do carnê O agendamento local é uma capacidade da fundação, disponível apenas no laboratório com processador fictício nesta entrega. Não está habilitado para Asaas ou Mercado Pago. Seu cronograma separa parcelas previstas das já emitidas: somente uma parcela com identificador confirmado vira cobrança. O carnê reúne instrumentos existentes e identifica as parcelas previstas. O documento pode estar pendente, pronto, falhou (permite repetir) ou indisponível para a conexão. Uma falha não significa recebimento nem deve levar à criação de outra cobrança. A página pública permite consultar os instrumentos de uma cobrança disponível; seu status pode atrasar até a próxima atualização da plataforma. Casos de uso - Conciliar um PIX pago por fora: marque a cobrança como paga com a justificativa, mantendo o histórico coerente. - Limpar cobranças de teste: arquive em lote e, em seguida, exclua definitivamente as arquivadas. - Estornar em massa: selecione as cobranças pagas e reembolse em lote (total). Dicas, limites e boas práticas - Cancelar só vale para cobranças em aberto; para uma cobrança paga, o caminho é o reembolso. - O parcelamento é definido na criação. Numa cobrança já emitida você troca a forma de pagamento, o vencimento, o valor pelo desconto, a descrição e as condições de pagamento; não troca entre à vista e parcelado nem muda o número de parcelas. Isso é limite dos gateways: a atualização de cobrança do Asaas não aceita o número de parcelas e não existe endpoint para alterar um parcelamento já criado; o Mercado Pago não edita cobrança. Para mudar o parcelamento, cancele e crie outra. - Numa parcela de um plano, a edição altera apenas multa, juros e desconto, e vale para as parcelas em aberto do plano. - O reembolso depende do gateway — o tipo (total/parcial) e o prazo de devolução seguem as regras do provedor e do meio de pagamento. - O webhook continua sendo a fonte da verdade: a baixa manual serve para o que foi pago por fora; os pagamentos do próprio gateway chegam e atualizam o status sozinhos. - Desfazer baixa manual só funciona no que você liquidou manualmente — não é o caminho para reverter um pagamento real do gateway (use o reembolso). - Se o valor está correto, mas o cliente, pedido ou evento de recuperação está errado, use Corrigir cliente e vínculos; não cancele nem reembolse apenas para consertar uma associação. Solução de problemas - "Não consigo excluir": a cobrança precisa estar arquivada primeiro; e cobranças pagas/ reembolsadas nunca são excluídas (ficam para auditoria). Arquive-a em vez de tentar apagar. - "Desfazer indisponível": a baixa manual só pode ser desfeita pela mesma origem — apenas uma cobrança que você marcou como paga manualmente (em gateway compatível) pode ser revertida. - "Marcar como pago indisponível": a cobrança não está em aberto ou o gateway não suporta baixa manual. - "Editar está indisponível em uma cobrança paga": os fatos liquidados são imutáveis. Para corrigir apenas cliente, organização, negócio ou conversa, use Corrigir cliente e vínculos da venda. - Ação em lote ignorou cobranças: é o comportamento esperado — inelegíveis (status incompatível ou gateway sem o recurso), IDs ausentes e itens fora da visão permitida aparecem como não processados e permanecem selecionados para revisão. - A lista não carregou: use Tentar novamente; se ainda falhar, revise a conexão com o servidor. - O atalho abriu a lista, mas não o detalhe: confirme que a cobrança pertence à mesma conta e que seu perfil pode consultá-la. O parâmetro do endereço não amplia permissões. Veja também - Visão geral de Pagamentos - Criar cobrança e enviar na conversa - Reembolsos, webhooks e relatórios - Conectar gateway: Asaas e Mercado Pago - Planos de cobrança e carnê - Página pública de cobrança

Ofertas: order bump, upsell e downsell

Visão geral Uma oferta é um preço reutilizável que você cadastra uma vez e reaproveita em várias vendas. Existem três tipos: - Order bump: aparece no checkout como uma oferta-relâmpago e, quando aceita, entra como uma linha extra na cobrança que está sendo criada. - Upsell: oferta pós-compra de um clique, normalmente um item de maior valor, que gera uma nova cobrança para o contato. - Downsell: também pós-compra de um clique, usada como alternativa mais barata quando o cliente recusa o upsell — igualmente gera uma nova cobrança. Em todos os casos a oferta guarda nome, valor, moeda e método; você só a vincula a uma venda ou contato no momento certo. Pré-requisitos - Um gateway conectado e válido (veja Conectar gateway). - Opcional: um produto do Catálogo vinculado à oferta (catalog_product_id), para reaproveitar o cadastro do produto. - Defina na oferta a conexão (gateway) e o método (billing_type) que serão usados quando ela virar cobrança — especialmente para upsell e downsell. - Para aceitar uma oferta (upsell/downsell), o contato precisa de dados mínimos (nome e, idealmente, e-mail/telefone) para o pagador no gateway. Como funciona - Order bump no checkout: a oferta é convertida em uma linha de cobrança (nome, valor e moeda são "fotografados" no momento). Ela soma ao total somando uma nova linha — nunca altera o valor de uma cobrança já existente. A linha guarda apenas a referência da oferta nos metadados. - Upsell / downsell pós-compra: ao aceitar a oferta para um contato, a plataforma cria uma nova cobrança reaproveitando a conexão, o valor e os dados do pagador já conhecidos — sem redigitar nada. Essa cobrança segue o fluxo normal (gateway → webhook → cartão de pagamento na conversa), exatamente como qualquer outra cobrança. - A oferta nunca é alterada quando é aceita: ela é um modelo; cada aceite gera uma cobrança nova e independente. - O aceite pós-compra só funciona para uma oferta ativa e não arquivada. Um order bump pertence ao checkout e é recusado nessa ação. Repetir a mesma tentativa de rede recupera a mesma cobrança. Passo a passo 1. Na área de Pagamentos, abra Ofertas e crie uma nova oferta. 2. Informe nome, escolha o tipo (order bump, upsell ou downsell), o valor e a moeda. 3. Defina o método e a conexão (gateway) que serão usados ao gerar a cobrança. 4. (Opcional) Vincule um produto do catálogo e escreva uma descrição. 5. Salve. A oferta fica disponível enquanto estiver ativa. 6. Para aplicar um order bump, use a oferta no checkout: aceita pelo cliente, ela vira uma linha extra na cobrança. 7. Para aceitar um upsell/downsell, uma integração autorizada chama a API de aceite para o contato, com empresa e conversa explícitas quando aplicáveis. A operação gera uma nova cobrança; criar a oferta no catálogo não executa esse aceite. 8. Para desativar uma oferta, arquive-a — ela some das ofertas disponíveis, mas o preço é preservado (nunca apagamos um preço que um funil ativo possa referenciar). Configurações & opções Catálogo, aceite e pagador são decisões diferentes Criar ou salvar uma oferta apenas cadastra uma opção no catálogo; não cria uma cobrança nem inicia uma assinatura. A tela de Ofertas gerencia esse catálogo. Ela não possui um botão de aceite pós-compra nesta versão. Uma integração autorizada pode aceitar um upsell/downsell pela API. O aceite exige o contato responsável e pode informar organization_id explicitamente para cobrar uma empresa vinculada a esse contato; conversation_id conserva o contexto da conversa quando informado. O cadastro fiscal da empresa deve estar completo para o gateway e método escolhidos. Sem seleção explícita de empresa, não deduza o pagador pelo produto ou negócio. A tentativa precisa manter sua chave de idempotência; um aceite é uma operação financeira, não uma simples consulta ao catálogo. Um order bump é somente uma linha adicional no checkout que está sendo composto. Salvar a oferta ou adicionar essa linha não emite, por si só, uma cobrança. O endpoint de aceite pós-compra recusa order bump; não o use para iniciar uma cobrança implícita. A emissão e eventual envio na conversa continuam ações próprias do fluxo de cobrança. Campos de uma oferta: | Campo | Para que serve | |---|---| | Nome | Identifica a oferta e vira a descrição da cobrança/linha. Obrigatório. | | Tipo (kind) | order_bump, upsell ou downsell. | | Valor | Preço da oferta (unidades maiores, ex.: 49.90). Precisa ser maior que zero. | | Moeda | Código de 3 letras (ex.: BRL). | | Método (billing_type) | PIX, boleto ou cartão usado quando a oferta virar cobrança. | | Conexão | O gateway (conexão de pagamento) usado para cobrar. | | Produto do catálogo | Vínculo opcional a um produto do Catálogo. | | Descrição | Texto auxiliar da oferta. | | Ativa / inativa | Ofertas inativas não são oferecidas. | Casos de uso - Aumentar o ticket com um order bump no checkout ("adicione a garantia estendida por R$ 19,90"). - Oferecer um upsell logo após a compra ("leve a versão Pro com 1 clique"). - Recuperar a venda com um downsell quando o cliente recusa o upsell mais caro. - Reutilizar a mesma oferta em várias conversas e checkouts, sem recadastrar o preço. Dicas, limites e boas práticas - O order bump não altera uma cobrança já criada — ele apenas adiciona uma linha ao total no momento do checkout. - Aceitar upsell/downsell sempre cria uma cobrança nova e independente; a oferta original permanece intacta. - Ofertas são arquivadas, não apagadas — assim nenhum funil ou histórico que dependa daquele preço quebra. - Defina conexão e método na oferta de upsell/downsell: sem eles, o aceite não consegue gerar a cobrança corretamente. - Valores são em unidades maiores (R$ 49,90 = 49.90); o total do checkout é a soma das linhas — nunca divida por 100. Solução de problemas - A oferta não aparece: confira se ela está ativa e não arquivada (ofertas inativas ou arquivadas não são oferecidas). - O aceite falhou: verifique se o contato tem os dados mínimos e se a conexão (gateway) da oferta é válida — o aceite cria uma cobrança real e precisa desses dados. - O valor saiu errado no order bump: lembre que ele soma uma linha ao total; ele não substitui nem reduz o valor das demais linhas. - Não consigo excluir uma oferta: ofertas são arquivadas (reversível) e não removidas — use o arquivar. Veja também - Criar cobrança e enviar na conversa - Conectar gateway: Asaas e Mercado Pago - Catálogo nativo de produtos e serviços