Guia completo de Stripe
Use Stripe Checkout para cartão, assinaturas e pagamentos internacionais com confirmação por webhook.
Tour visual na empresa Demo
Da configuração ao acompanhamento
Use as telas reais abaixo para reconhecer cada etapa sem expor credenciais.
1 Abrir configuração
Configure a integração
Preencha somente as credenciais da própria empresa e salve.
Etapa 1 de 2
01PrepareSepare conta e credenciais.
02ConfigurePreencha e salve com segurança.
03TesteUse um cenário demonstrativo.
04AcompanheValide o resultado e os logs.
O que esta integração faz
| Integração | Stripe |
| Categoria | Gateway de pagamento |
| Configuração | Individual por empresa; credenciais não são compartilhadas. |
| Acesso | Integrações > Stripe |
Use Stripe Checkout para cartão, assinaturas e pagamentos internacionais com confirmação por webhook.
Antes de configurar
- Conta Stripe ativada.
- Publishable key e Secret key do mesmo modo.
- Moeda padrão definida.
- Webhook criado no painel Stripe.
Não misture chaves de teste com chaves de produção. A Secret key e o signing secret nunca devem aparecer em mensagens ou prints.
Passo a passo completo
- Abra Integrações e acesse Stripe.
- Informe Publishable key, Secret key e a moeda padrão em código ISO.
- Crie um endpoint no painel Stripe usando a URL mostrada no CRM.
- Assine pelo menos checkout.session.completed e payment_intent.succeeded.
- Copie o signing secret do endpoint para Segredo do webhook e salve.
- Selecione Stripe em Apps > Cobranças > Configurações.
- Crie um checkout piloto e confira o evento na aba Logs.
Primeiro teste recomendado
Faça uma configuração controlada na empresa Demo, confirme o resultado esperado e somente depois replique em uma operação real.
Entenda os campos e elementos
| Publishable key | Identificador público usado pelo checkout. |
| Secret key | Credencial privada para criar e consultar pagamentos. |
| Moeda padrão | Código ISO como brl, usd ou eur. |
| Segredo do webhook | Signing secret do endpoint criado na Stripe. |
| Eventos | checkout.session.completed e payment_intent.succeeded confirmam o fluxo principal. |
Onde e como usar
| Cartão | Checkout hospedado e seguro. |
| Internacional | Cobranças em moedas suportadas pela conta. |
| Assinaturas | Fluxos recorrentes conforme a configuração comercial. |
| Cobranças | Links gerados e acompanhados no app do CRM. |
A configuração conecta o provedor. O recurso efetivamente usado é escolhido no agente, automação ou app Cobranças, conforme a categoria.
Diagnóstico rápido
| Checkout não abre | Revise a Secret key e a moeda informada. |
| Pagamento não baixa | Confira os eventos do endpoint e a aba Logs. |
| Assinatura inválida | Atualize o Segredo do webhook com o signing secret correto. |
| Evento duplicado | O CRM trata notificações repetidas; use os logs para conferir o resultado. |
Checklist de segurança
- Use somente credenciais pertencentes à empresa.
- Nunca envie chaves, tokens ou segredos por mensagens.
- Comece em ambiente de teste quando o provedor oferecer essa opção.
- Revise permissões e limites da conta externa.
- Faça um primeiro teste controlado.
- Consulte logs e confirme o resultado antes de liberar para a equipe.
Dúvidas frequentes
Qual moeda devo informar?
Use o código ISO em minúsculas, como brl, usd ou eur.
Onde encontro o segredo do webhook?
No endpoint criado em Developers > Webhooks no painel Stripe.
Posso testar sem cobrança real?
Sim. Use todas as credenciais no modo de teste.
Quais eventos são necessários?
O fluxo principal utiliza checkout.session.completed e payment_intent.succeeded.
O suporte precisa da minha chave para ajudar?
Não envie a credencial. Compartilhe apenas prints sem dados sensíveis, a mensagem de erro e o horário do teste.