Pagamentos (Stripe)
Gere links de pagamento nas propostas usando a sua própria conta Stripe (modelo BYO).
A integração de Pagamentos usa a SUA conta Stripe (modelo BYO, "traga a sua própria conta"). Os pagamentos caem direto na sua conta Stripe: não há custo, margem nem intermediação nossa. Nós só programamos os campos e o botão para gerar o link.
A integração nasce inerte: nada acontece até você colar a sua chave e ativar. As chaves ficam cifradas no CRM e nunca são exibidas de volta.
Pré-requisitos
- Uma conta Stripe ativa (para cobrar de verdade, a conta precisa estar habilitada para pagamentos no seu país).
- Acesso ao Painel do Stripe com permissão para ver as chaves de API (Desenvolvedores → Chaves de API) e criar webhooks (Desenvolvedores → Webhooks).
- No Sellio, ser administrador para salvar as chaves e ativar a integração em Configurações → Integrações.
O que você precisa colar
- Secret key: no Painel do Stripe, em Desenvolvedores → Chaves de API (começa com sk_live_ em produção ou sk_test_ em teste).
- Webhook signing secret (opcional no início): gerado quando você cria o webhook no Stripe (começa com whsec_). É ele que permite confirmar os pagamentos automaticamente.
Como configurar
- Abra Configurações → Integrações e localize o cartão "Pagamentos (Stripe)".
- Cole a sua secret key do Stripe e clique em "Salvar chaves".
- Copie a "URL do webhook do Stripe" que aparece e, no Painel do Stripe (Desenvolvedores → Webhooks), crie um endpoint para essa URL com os eventos checkout.session.completed e payment_intent.succeeded.
- Volte ao CRM, cole o webhook signing secret (whsec_...) junto com a secret key e salve novamente.
- Clique em "Ativar".
Como gerar um link de pagamento
- Abra uma oportunidade e vá até a seção de Propostas.
- Na versão desejada, clique em "Link de pagamento": o CRM cria um link no Stripe com o valor total da proposta e o copia para a sua área de transferência.
- Envie o link ao cliente. Quando ele pagar, o Stripe avisa o CRM pelo webhook e o pagamento aparece como "Pago" na proposta.
💡 Se você tentar gerar um link sem ter configurado o Stripe, o CRM avisa de forma clara e nada é cobrado: a funcionalidade fica inerte até a chave estar no lugar. Quando um pagamento ligado a uma proposta é confirmado, a proposta é marcada como aceita automaticamente.
Trate a URL do webhook como secreta e cole sempre as duas chaves juntas ao trocá-las (por segurança, o CRM não mostra as chaves salvas de volta).
Como testar
- Use as chaves de TESTE (sk_test_.../whsec_ do modo de teste) para não cobrar de verdade.
- Gere um "Link de pagamento" em uma proposta e abra-o: você deve cair no checkout do Stripe com o valor total da proposta.
- Pague com um cartão de teste do Stripe (ex.: 4242 4242 4242 4242). Confirme que a proposta passa a "Pago" e é marcada como aceita: sinal de que o webhook chegou e a assinatura conferiu.
- No Painel do Stripe (Desenvolvedores → Webhooks → seu endpoint), veja o histórico de eventos entregues e o status 200.
Solução de problemas
- Erro ao gerar o link / 401 no Stripe: a secret key está errada ou é de outro modo (você colou a de teste mas está em produção, ou vice-versa). Recole a sk_ correta.
- O cliente paga mas a proposta não vira "Pago": o webhook não está confirmando. Verifique se você criou o endpoint no Stripe apontando para a "URL do webhook do Stripe" com os eventos checkout.session.completed e payment_intent.succeeded.
- Assinatura inválida no webhook: o webhook signing secret (whsec_...) no CRM não bate com o do endpoint no Stripe. Copie o secret do endpoint e cole-o JUNTO com a secret key (salve as duas juntas).
- 404 na URL do webhook: a integração não está ativada ou o token da URL mudou: reative e recopie a URL para o Stripe.
- Nada acontece ao gerar o link: a integração está inerte por falta de chave. Cole a secret key e ative primeiro.