Pular para o conteúdo principal
Conecte o Stripe pelo Marketplace para habilitar o provedor no seu workspace e disponibilizar suas ferramentas de pagamento no Brain Studio. O Stripe se conecta usando o modelo BYOK (Bring Your Own Key), usando sua própria conta.

​
Antes de começar

Certifique-se de que você tem:
  • Uma conta Stripe ativa
  • Uma Secret API Key (sk_) (Teste ou Produção)
Se você ainda não tem sua Secret API Key, siga o guia Obtendo credenciais.

​
Conectar pelo Marketplace

1

Abrir o Marketplace

No Brain Studio, acesse o Marketplace pelo menu lateral.Você pode encontrar o Stripe na categoria Pagamentos & Processamento ou usando a barra de pesquisa.
Stripe no catálogo de integrações do Marketplace
2

Selecionar Stripe

Clique no card do Stripe para abrir sua visualização de detalhes.
3

Clicar em Instalar (ou Conectar)

Clique em Instalar.Em algumas versões da interface, o botão pode aparecer como Conectar. Ambos servem para o mesmo propósito: iniciar a conexão com o provedor.
4

Inserir sua Secret API Key

Um modal será aberto solicitando uma API Key.
Modal para inserir a Secret API Key do Stripe
Cole sua Secret API Key (sk_test_... ou sk_live_...) e confirme a instalação.
Não use a Publishable Key (pk_). O Brain Studio requer uma Secret Key (sk_) para funcionar corretamente.
5

Integração pronta para uso

O Brain Studio validará a chave e conectará o Stripe ao seu workspace.
Se o Stripe aparecer como instalado no Marketplace e suas ferramentas estiverem disponíveis no Canvas, a integração foi habilitada com sucesso.

​
Usando credenciais de Teste vs Produção

Você pode conectar a integração com:
  • Secret Key de Teste (sk_test_) → Para ambientes de teste ou QA.
  • Secret Key de Produção (sk_live_) → Para processar pagamentos reais.
O ambiente que você usa dependerá da chave inserida no momento da instalação.
Chaves de teste não processam pagamentos reais. Certifique-se de usar credenciais de Produção antes de entrar em produção.

​
Alterando a API Key

Se você precisar migrar de Teste para Produção (ou rotacionar credenciais):
1

Desinstalar a integração

Remova ou desinstale o Stripe do Marketplace.
2

Reinstalar

Repita o processo de conexão e insira a nova Secret API Key.
Após reinstalar, a integração usará as novas credenciais.

​
Próximo passo

Após conectar a integração, continue com:

Uso e configuração

Configure as ferramentas do Stripe e trate os estados de pagamento no seu fluxo.