Pagamentos
Por Conversa Labs
Por Conversa Labs
Conectar gateway (Asaas/Mercado Pago), criar cobranças (PIX/boleto/cartão), assinaturas, descontos, agendamento pago e relatórios.
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 - 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. 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
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 - 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. - Métodos suportados por gateway: | Recurso | Asaas | Mercado Pago | |---|---|---| | PIX | Sim | Sim | | Boleto | Sim | Sim | | Cartão (checkout hospedado) | Sim | Sim | | Parcelamento | Sim | Sim | | Assinaturas | Sim | Sim | | Planos reutilizáveis | — | Sim | | Reembolso parcial | Sim | Sim | 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. Veja também - Visão geral de Pagamentos - Criar cobrança e enviar na conversa - Reembolsos, webhooks e relatórios
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. 8. Acompanhe o status mudar de pendente para pago automaticamente quando o gateway confirmar. Configurações & opções - Métodos: PIX (QR Code + copia-e-cola), boleto (linha digitável/PDF) e cartão via checkout hospedado — a plataforma nunca pede o número do cartão. - Itens (linhas de cobrança): descreva cada produto/serviço com quantidade e valor; o total é a soma das linhas. - Vencimento: data limite para PIX/boleto. - Marcar como pago manualmente: registre pagamentos recebidos por fora (quando o gateway suportar), para manter o histórico coerente. - Reenviar: é possível reenviar o cartão de pagamento na conversa a qualquer momento. Casos de uso - Fechar a venda no WhatsApp e mandar o PIX na hora. - Montar uma cobrança com vários itens a partir do catálogo. - Cobrar um negócio ganho no CRM sem redigitar o valor. - Oferecer ao cliente a escolha entre PIX e cartão. Dicas, limites e boas práticas - Valores são em unidades maiores (R$ 49,90 = 49.90); o total é a soma de preço × quantidade das linhas — nunca divida por 100. - O cartão sempre passa pelo checkout hospedado do gateway: zero dados de cartão na plataforma. - Confirme nome e contato do cliente antes de criar — o gateway usa esses dados para identificar o pagador. - Não confie na tela de "sucesso": o status real chega pelo webhook. Solução de problemas - Erro ao criar a cobrança: verifique se o gateway está conectado e se o contato tem os dados mínimos. - Cliente não recebeu o PIX: reenvie o cartão de pagamento na conversa. - Pago mas continua pendente: confira a configuração do webhook (veja Reembolsos, webhooks e relatórios). - Recurso indisponível (ex.: cartão): pode ser uma limitação do gateway escolhido — confira a matriz de recursos em Conectar gateway. 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
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. No Mercado Pago você também pode usar planos reutilizáveis (um modelo de assinatura que serve a vários clientes). No Asaas, a recorrência é configurada diretamente na assinatura. Pré-requisitos - Um gateway conectado que suporte assinaturas (Asaas e Mercado Pago suportam). - Para planos reutilizáveis, use o Mercado Pago (o Asaas não expõe planos como entidade separada). - 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, Mercado Pago) Vincule a um plano já criado. 6. Salve. O gateway passa a gerar as cobranças no ciclo definido. 7. Acompanhe cada cobrança gerada e o estado da assinatura na plataforma; o cliente recebe a cobrança normalmente. Configurações & opções - Ciclo: semanal, quinzenal, mensal, trimestral, semestral ou anual (a oferta exata depende do gateway). - Estado da assinatura: ativa, pausada, cancelada — refletido a partir das notificações do gateway. - Planos (Mercado Pago): crie um plano uma vez e reutilize-o em várias assinaturas. - 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. 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 - A recorrência é delegada ao gateway — ele é quem gera e cobra cada ciclo; a plataforma reflete o resultado. - Use planos (Mercado Pago) quando muitos clientes assinam a mesma oferta — fica mais fácil de manter. - 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: planos reutilizáveis são um recurso do Mercado Pago; no Asaas configure a recorrência na própria assinatura. - 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
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 - 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. 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
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
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 - 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