Você precisa de uma conta Stripe ativa, acesso ao painel do Stripe e permissões para visualizar/criar API Keys e Webhooks.
Não é necessário conhecimento técnico avançado.
Teste (sk_test_...): para testes sem transações reais.
Produção (sk_live_...): para cobranças reais em produção.
O Brain Studio se conecta ao Stripe usando a chave que você inserir.
Se você instalar com uma chave de Teste, sua integração permanece em modo de teste.
Se você instalar com uma chave de Produção, ela está pronta para produção.
Via configurações (ícone no canto superior direito → Developers → Manage API keys)
No menu lateral esquerdo, encontre a seção Developers e clique em API Keys.
Acesso direto a Developers no menu lateral
3
Escolha o ambiente (Teste ou Produção)
O Stripe pode exibir o modo de teste de duas formas (dependendo da sua conta):
Uma opção como “Test mode” / “Switch to a test environment” no seletor de conta.
Uma barra superior indicando que você está usando dados de teste.
Alternando para 'Test mode'
Se sua conta estiver em modo de Produção, é normal ver chaves com live na seção de API Keys.
Para obter chaves de Teste, você deve entrar no modo de teste e retornar a esta mesma tela.
Saindo do 'Test mode'
4
Criar (ou copiar) sua Secret API Key
Em API Keys, você verá dois tipos de chaves:
Publishable key (pk_...) → NÃO é usada para instalar o Stripe no Brain Studio
Secret key (sk_...) → SIM, esta é a que você precisa
No Brain Studio você deve sempre usar uma Secret API Key (sk_test_... ou sk_live_...).
Não use a Publishable Key (pk_...).
Se você já tem uma Secret key pronta para uso, pode copiá-la.
Se precisar criar uma nova, clique em Create secret key.
Seção 'Standard Keys' com botão 'Create secret key'
5
Escolha o tipo de chave (recomendado: Standard)
Ao criar uma chave, o Stripe geralmente exibe opções como:
How I’m building my integration (chave padrão / acesso total)
I’m providing this key to another website (o Stripe sugere uma chave restrita)
Para o Marketplace (BYOK) e para evitar atrito, recomendamos usar uma chave padrão.
Opções de criação de secret key
O Stripe pode recomendar chaves restritas para compartilhamento com terceiros.
Na Jelou, a chave é armazenada de forma segura no nível da plataforma (não fica exposta ao usuário final).
Se você precisar de controle adicional, revise a seção Chaves restritas (opcional) ao final deste guia.
Se a chave copiada começa com sk_test_ ou sk_live_, você tem tudo o que precisa para instalar o Stripe.
Entrega da secret key
6
Use a Secret API Key no Brain Studio
Durante a instalação pelo Marketplace, o Brain Studio solicitará uma única credencial: API Key.Cole sua Secret API Key (sk_test_... ou sk_live_...) e confirme.
Modal de instalação do Brain Studio solicitando 'API Key' para o Stripe
Após configurado:
As cobranças são processadas diretamente na conta Stripe do comerciante.
A Jelou não retém fundos.
O resultado do pagamento retorna ao fluxo para continuar com base no status real.
O Stripe permite criar Chaves Restritas (geralmente vistas como rk_...) com permissões específicas.Você pode usar uma chave restrita se sua organização exigir maior controle, mas deve garantir que as permissões necessárias estejam habilitadas para que o Stripe funcione corretamente no Brain Studio.
Parte 2 — Configurar webhooks no Stripe (obrigatório)
A Jelou precisa que o Stripe envie eventos de pagamento à plataforma para alinhar o resultado da cobrança com seu fluxo no Brain Studio. Isso é configurado no Stripe Dashboard: você cria um endpoint de webhook e seleciona os eventos indicados abaixo.
Sem webhooks corretos, um pagamento pode ser concluído no Stripe e, ainda assim, o fluxo no Brain Studio pode ficar inconsistente (por exemplo, pendente ou sem avançar para a saída esperada do nó).
O Stripe distingue modo de teste (Test) e modo de produção (Live). Configure um webhook por modo se for usar os dois. A Secret API Key que você instalará no Marketplace (sk_test_... ou sk_live_...) deve corresponder ao mesmo modo que o webhook que você está configurando no painel.
No campo de URL do endpoint, cole o endereço da aba acima de acordo com o modo em que você está trabalhando. Revise o resumo: devem constar os três eventos e o tipo webhook. Crie ou salve o destino.
2
Repetir no outro modo (se aplicável)
Se você usar Teste e Produção, volte e crie o endpoint no outro modo do Dashboard com a outra URL (jelou.dev para Teste, jelou.ai para Produção).
URL de webhook da Jelou inserida no endpoint do Stripe
Antes de continuar, confirme no painel que o destino foi registrado corretamente:
1
Revisar a lista de destinos
Em Stripe → Workbench → Webhooks, o endpoint recém-criado deve aparecer com status Ativo.
2
Confirmar eventos e URL
Abra o detalhe do destino e verifique que:
Ele escuta exatamente os três eventos (payment_intent.succeeded, payment_intent.requires_action, payment_intent.payment_failed)
A URL aponta para o endereço correto da Jelou para seu ambiente (jelou.dev para Teste, jelou.ai para Produção)
Se o destino aparecer como Ativo com os três eventos e a URL da Jelou, a configuração no Stripe está completa.
Se algo não bater, verifique nesta ordem: que o modo do Dashboard (Teste vs Produção) corresponde à URL, que os três eventos estão selecionados e que a URL não tem espaços ou caracteres extras.
