Configurar pagamentos
Para gerar links de pagamento, o DeepLead precisa de um gateway conectado: Stripe ou Asaas. A mesma tela define em qual conta do fluxo de caixa os recebimentos são lançados.
# Onde fica
Com o módulo Financeiro selecionado no topo do menu, abra Configurações → Pagamentos e receita. A tela se chama Configurações Financeiras e tem três blocos: Gateways de Pagamento, Contas Padrão e Notificação de Cobrança (este último está em Notificação de cobrança).
# Quem pode usar
Perfil Admin, com o módulo Financeiro liberado para a empresa.
# Os gateways
| Gateway | Como o seu cliente paga | Atenção |
|---|---|---|
| Asaas | Na página de pagamento do Asaas, escolhendo Pix, boleto ou cartão | O contato precisa ter CPF/CNPJ cadastrado |
| Stripe | No checkout do Stripe, com cartão | É o único que cobra em dólar (USD) |
Você pode manter os dois ativos e escolher por qual cobrar a cada cobrança ou contrato.
# Conectar um gateway
- No cartão do gateway, clique em Configurar Stripe ou Configurar Asaas.
- Passo 1: Credenciais. Escolha o Ambiente: Sandbox (testes) ou
Produção. Cole as chaves do painel do gateway (a tela tem o link):
- Stripe: Secret Key (começa com
sk_) e Publishable Key (começa compk_). - Asaas: API Key (começa com
$aact_).
- Stripe: Secret Key (começa com
- Clique em Salvar e continuar.
- Passo 2: Configurar Webhook. O webhook é o aviso que o gateway manda ao
DeepLead quando um pagamento muda de situação. Sem ele, a cobrança paga continua
Pendente na sua tela.
- Asaas: o DeepLead cadastra o webhook na sua conta Asaas ao salvar. Não é preciso copiar nada.
- Stripe: copie a Webhook URL e cadastre no painel do Stripe (link Abrir
configuração de webhooks no Stripe). Selecione os eventos
checkout.session.completed,invoice.paid,invoice.payment_failed,charge.refundedecustomer.subscription.deleted.
- Clique em Testar conexão. Se as chaves estiverem certas, aparece Configuração concluída!. Clique em Fechar.
- No cartão do gateway, ligue a chave de Inativo para Ativo.
A partir daí o gateway aparece no campo Cobrar por das cobranças e na opção Online dos contratos, com a indicação (Produção) ou (Sandbox).
No Stripe, o campo Webhook Signing Secret (opcional) do passo 2 só é gravado pelo botão Salvar e continuar. Depois de colar o valor, clique em Voltar, em Salvar e continuar de novo (as chaves podem ficar em branco: as já salvas são mantidas) e então em Testar conexão.
# Situação do gateway
O cartão mostra a situação, o ambiente e a data da Última verificação.
| Situação | O que significa |
|---|---|
| Pendente | As chaves foram salvas, mas a conexão ainda não foi testada |
| Conectado | O teste passou |
| Erro | O teste falhou; confira as chaves e o ambiente |
Para um gateway ser usado, ele precisa estar Conectado e Ativo ao mesmo tempo.
# Trocar chaves ou ambiente
Clique em Reconfigurar e refaça os passos. Deixar um campo de chave em branco mantém a chave atual. Toda vez que você salva, a situação volta para Pendente: teste a conexão de novo, senão o gateway some das telas de cobrança até o teste passar.
# Contas Padrão
# Conta padrão do fluxo de caixa
É a conta do Fluxo de Caixa que recebe os lançamentos automáticos:
- a receita criada quando o gateway confirma o pagamento de uma cobrança;
- os lançamentos de contratos com cobrança offline (dinheiro, PIX manual, boleto manual e os demais meios sem gateway).
Escolha a conta no campo Conta padrão. A troca é salva na hora e só pode haver uma conta padrão por vez. Sem conta padrão, esses lançamentos não são criados.
A lista traz as contas ativas. Se aparecer Nenhuma conta financeira cadastrada, crie uma em Fluxo de Caixa, aba Contas, e volte.
# Stripe
Os campos Conta padrão — BRL (R$) e Conta padrão — USD ($) guardam a conta associada a cada moeda do Stripe. Escolha e clique em Salvar configurações. O lançamento automático de pagamento confirmado usa a conta padrão do fluxo de caixa, do bloco acima.
# Problemas comuns
| Mensagem | O que fazer |
|---|---|
| Secret Key é obrigatória / API Key é obrigatória | Na primeira configuração a chave não pode ficar em branco |
| Secret key inválida. Deve começar com ‘sk_’. | Você colou outra chave no campo; copie a Secret Key no painel do Stripe |
| API key inválida. Deve começar com ‘$aact_’. | Copie a API Key inteira no painel do Asaas |
| Credenciais inválidas. Verifique sua Secret Key do Stripe. / API Key inválida. Verifique sua chave Asaas. | A chave não foi aceita. Confira se ela é do mesmo ambiente escolhido (Sandbox ou Produção) |
| Timeout ao conectar com o gateway. Tente novamente. | O gateway não respondeu a tempo; teste de novo |
| Gateway salvo, mas o webhook não foi configurado | O Asaas não aceitou o cadastro do webhook. A mensagem traz o motivo. Corrija e salve de novo |
| Teste a conexão primeiro | A chave Ativo só liga com a situação Conectado |
| Nenhum gateway conectado e ativo. (ao gerar cobrança) | Falta testar a conexão ou ligar a chave Ativo |
Cobrança paga no gateway que continua Pendente no DeepLead é sinal de webhook ausente ou desativado. No Asaas, clique em Reconfigurar, depois em Salvar e continuar (o DeepLead refaz o cadastro do webhook) e em Testar conexão. No Stripe, confira a URL e os eventos no painel.