Receba online com Pagar agora (cartão ou banco, com Stripe)

Com o pagamento on-line, seus clientes podem pagar uma fatura com cartão ou pelo banco em poucos cliques: um botão Pagar agora aparece no e-mail da fatura, nos lembretes de pagamento, na página on-line da fatura e no portal do cliente. O dinheiro vai direto para a sua própria conta Stripe (a Stripe é a empresa de pagamentos que recebe o pagamento). O Kaam360 nunca vê dados de cartão ou de banco, e marca a fatura como paga sozinho quando a Stripe confirma o pagamento.

Quem pode configurar: administradores e qualquer pessoa cuja função tenha a permissão Configurar pagamentos online (veja Crie suas próprias funções). Faz parte dos pacotes Team e Business.

1. Abra uma conta Stripe

1. Acesse stripe.com e crie uma conta (abrir é grátis; a Stripe cobra uma pequena taxa de cada pagamento).
2. A Stripe começa no modo de teste: nada é real, então você pode testar tudo com segurança. Para receber pagamentos reais depois, a Stripe pede os dados da sua empresa e do banco (Ativar pagamentos).

2. Conecte ao Kaam360 (comece no modo de teste)

1. Na Stripe, abra Desenvolvedores > Chaves de API. Confira se o Modo de teste está ligado (o seletor no topo).
2. Ao lado de Chave secreta, clique em Revelar chave de teste e copie-a. Ela começa com sk_test_.
3. No Kaam360, clique em Configurações e depois no cartão Pagamentos online.
4. Cole a chave em Chave secreta e clique em Conectar. O Kaam360 confere a chave com a Stripe e mostra Conectada e Modo de teste.

A chave fica guardada criptografada e nunca mais é exibida por inteiro; só os quatro últimos caracteres aparecem, para você reconhecê-la. Nunca cole a chave publicável (pk_...): o Kaam360 pede a chave secreta.

3. Adicione o webhook (para os pagamentos serem registrados sozinhos)

Um webhook é como a Stripe avisa o Kaam360 de que "esta fatura foi paga". Sem ele, o Pagar agora não é oferecido.

1. Em Pagamentos online, na seção Webhook, clique em Copiar ao lado de URL do endpoint.
2. Na Stripe, abra Desenvolvedores > Webhooks e clique em Adicionar endpoint (nas telas mais novas da Stripe: Adicionar destino, escolha Sua conta e Endpoint de webhook).
3. Cole o endereço em URL do endpoint.
4. Em Selecionar eventos, escolha exatamente os eventos listados na página do Kaam360: checkout.session.completed, checkout.session.async_payment_succeeded, checkout.session.async_payment_failed, checkout.session.expired, payment_intent.succeeded, payment_intent.payment_failed e charge.refunded, payout.paid, payout.failed. Clique em Adicionar endpoint.
5. Na página do endpoint na Stripe, em Segredo de assinatura, clique em Revelar e copie-o. Ele começa com whsec_.
6. De volta ao Kaam360, cole-o em Segredo de assinatura e clique em Salvar. O selo muda para Segredo de assinatura salvo.

4. Escolha o que os clientes veem

Em O que os clientes veem:

• Oferecer Pagar agora nas faturas: ative ou desative o pagamento on-line quando quiser.
• Formas de pagamento: Cartões (com Apple Pay e Google Pay quando o cliente os tem) e débitos bancários onde se aplicam: Conta bancária dos EUA (ACH Direct Debit) para dólares americanos, Débito direto SEPA para euros, Débito direto Bacs (Reino Unido) para libras. Ative cada um também na Stripe (Configurações > Formas de pagamento). Deixe todos desmarcados para oferecer exatamente o que está ativado na Stripe.
• Pagamentos parciais: marque Os clientes podem pagar parte de uma fatura para que eles possam digitar um valor (nunca maior que o saldo em aberto), e defina o Menor pagamento parcial.
• Taxa por pagar online: desligada (0%) por padrão. Alguns países e bandeiras de cartão proíbem ou limitam essas taxas, então verifique antes de acrescentar uma. O cliente a vê antes de pagar, e ela não é somada à fatura.
• Quais faturas: só algumas moedas (por exemplo USD, EUR) e, se você tiver várias empresas, só algumas delas.

Clique em Salvar.

5. Teste com um cartão de teste

1. Envie uma fatura para você mesmo (ou abra uma fatura emitida e clique em Aberta ao lado de A página online da fatura).
2. Clique em Pagar agora. A página de pagamento da Stripe se abre.
3. Pague com o cartão de teste da Stripe 4242 4242 4242 4242, qualquer data futura e quaisquer três dígitos.
4. Você volta à fatura, que agora aparece como paga. Na página da fatura no Kaam360, o cartão Pagamento online lista o pagamento, e você recebe uma notificação e um e-mail.

6. Entre em produção

1. Na Stripe, desligue o Modo de teste e conclua Ativar pagamentos.
2. Copie a chave secreta de produção (sk_live_...). Em Pagamentos online, clique em Alterar a chave, cole-a e clique em Conectar. O selo mostra Produção.
3. Adicione o webhook de novo no modo de produção (passo 3: a Stripe mantém os webhooks de teste e de produção separados) e salve o novo segredo de assinatura.

O que seus clientes veem

• O e-mail da fatura e os lembretes têm um botão Pagar agora. Nos lembretes, você também pode usar a palavra {pay_link}.
• A página on-line da fatura: um endereço privado criado para cada fatura, onde o cliente vê a fatura, baixa o PDF e paga, sem entrar. Na página da fatura, o cartão Pagamento online mostra o endereço com Copiar; a mensagem do WhatsApp o inclui.
• O portal do cliente: em uma fatura ainda em aberto, Pagar agora fica em Como pagar.

Suas próprias instruções de pagamento (dados bancários) continuam abaixo de Pagar agora, então os clientes ainda podem pagar do jeito habitual.

O que acontece depois de um pagamento

• Pagamentos com cartão são confirmados na hora: a fatura é marcada como paga (ou paga em parte, mostrando o que ainda falta), e o pagamento de projeto que ela cobra acompanha.
• Débitos bancários levam alguns dias. Até o banco confirmar, o pagamento mostra A caminho, e ninguém consegue pagar o mesmo valor duas vezes. Se o banco recusar, o pagamento mostra Falhou e você é avisado.
• A taxa da Stripe aparece ao lado de cada pagamento quando a Stripe a informa.
• O cliente recebe um recibo por e-mail, em nome da sua empresa.
• Você recebe uma notificação (o sino) e um e-mail; a pessoa que emitiu a fatura também.

Reembolsos

Faça os reembolsos no painel da Stripe (abra o pagamento e clique em Reembolsar). O Kaam360 acompanha sozinho: o pagamento mostra o valor reembolsado e a fatura volta a dever esse valor. Se o cliente não for pagar de novo, emita uma nota de crédito (veja Notas de crédito, reembolsos e extratos de clientes).

Se um cliente pagar duas vezes (por exemplo em duas abas do navegador), o segundo pagamento é registrado como mais do que o devido e você é avisado para reembolsar a diferença na Stripe.

Repasses para o seu banco

A cada poucos dias a Stripe envia ao seu banco o dinheiro recebido, menos as tarifas e eventuais reembolsos: um repasse. O Kaam360 lê cada repasse sozinho, com tudo o que contém, quando a Stripe envia payout.paid.

1. Em Pagamentos online, procure Repasses para o seu banco. Cada repasse mostra o dia em que chega, os pagamentos, reembolsos e tarifas da Stripe que contém e o que chega ao seu banco.
2. Clique em Mostrar para ver cada linha de um repasse: cada pagamento Pagar agora com a sua fatura, cada reembolso e cada tarifa. Um pagamento que não foi feito com Pagar agora no Kaam360 aparece como Fora do Kaam360.
3. Clique em Buscar repasses para ler de novo na Stripe os repasses dos últimos 60 dias (por exemplo logo depois de adicionar o webhook).

O estado diz como está cada repasse: A caminho, Pago, ainda não lançado, Lançado, linha do banco ainda não correspondida ou Conciliado.

No razão geral (com os lançamentos automáticos ligados), um pagamento Pagar agora que está num repasse vai primeiro para a conta Stripe clearing. No dia em que o repasse chega, o Kaam360 move o valor líquido de Stripe clearing para o seu banco e as tarifas da Stripe para Bank charges; uma taxa por pagar online que o cliente acrescentou vai para Other income. Quando importar o extrato bancário, a linha do banco desse repasse corresponde ao total do repasse: faça a correspondência em Extratos bancários e o repasse aparece como Conciliado.

Confira se tudo funciona

Em Pagamentos online:

• Pagamentos online lista cada pagamento, com status, taxa e cliente.
• Mensagens do Stripe lista cada mensagem que a Stripe enviou e o que o Kaam360 fez com ela. Uma mensagem enviada duas vezes só é usada uma vez.
• Se você vir um aviso de que uma mensagem tinha uma assinatura que não confere, o segredo de assinatura salvo no Kaam360 não é o desse webhook (ou é do outro modo). Copie-o de novo da Stripe e clique em Salvar.

Quem pode fazer o quê

Em Funções e permissões, na seção Finanças: Configurar pagamentos online conecta a conta e altera as opções (só administradores, até você dar a permissão a outras pessoas). Ver faturas mostra os pagamentos on-line de uma fatura e a página on-line dela. Conectar, alterar e desconectar ficam gravados no registro de auditoria, assim como cada pagamento e reembolso.