Skip to content

This article has not been translated yet.

On this page
Financeiro

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

  1. No cartão do gateway, clique em Configurar Stripe ou Configurar Asaas.
  2. 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 com pk_).
    • Asaas: API Key (começa com $aact_).
  3. Clique em Salvar e continuar.
  4. 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.refunded e customer.subscription.deleted.
  5. Clique em Testar conexão. Se as chaves estiverem certas, aparece Configuração concluída!. Clique em Fechar.
  6. 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.

# Veja também