> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar no Brain Studio

> Instale o Stripe pelo Marketplace no Brain Studio usando sua Secret API Key.

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 ter concluído estas duas etapas no Stripe Dashboard:

* Ter uma **Secret API Key (`sk_`)** (Teste ou Produção)
* Ter **configurado os webhooks** para que a Jelou receba eventos de pagamento

<Tip>
  Se você ainda não fez isso, siga primeiro o guia
  [Configurar sua conta no Stripe](/pt/guias/integracoes/pagamentos/provedores/stripe/configurar-no-stripe).
</Tip>

***

## Conectar pelo Marketplace

<Steps>
  <Step title="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.

    <Frame caption="Stripe disponível no catálogo do Marketplace">
      <img src="https://mintcdn.com/jelouai/y5L6vahGrhMqbaUQ/assets/images/integraciones/pagos/stripe-marketplace-catalogo.png?fit=max&auto=format&n=y5L6vahGrhMqbaUQ&q=85&s=d3f6aa726541fc347a53440b6da9301d" alt="Stripe no catálogo de integrações do Marketplace" width="2048" height="954" data-path="assets/images/integraciones/pagos/stripe-marketplace-catalogo.png" />
    </Frame>
  </Step>

  <Step title="Selecionar Stripe">
    Clique no card do **Stripe** para abrir sua visualização de detalhes.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Inserir sua Secret API Key">
    Um modal será aberto solicitando uma **API Key**.

    <Frame caption="Inserção da Secret API Key do Stripe">
      <img src="https://mintcdn.com/jelouai/y5L6vahGrhMqbaUQ/assets/images/integraciones/pagos/stripe-modal-credenciales.png?fit=max&auto=format&n=y5L6vahGrhMqbaUQ&q=85&s=34bfc651fb6bb3c998ad97dd460234ff" alt="Modal para inserir a Secret API Key do Stripe" width="1910" height="684" data-path="assets/images/integraciones/pagos/stripe-modal-credenciales.png" />
    </Frame>

    Cole sua **Secret API Key (`sk_test_...` ou `sk_live_...`)** e confirme a instalação.

    <Warning>
      Não use a **Publishable Key (`pk_`)**.
      O Brain Studio requer uma **Secret Key (`sk_`)** para funcionar corretamente.
    </Warning>
  </Step>

  <Step title="Integração pronta para uso">
    O Brain Studio validará a chave e conectará o Stripe ao seu workspace.

    <Check>
      Se o Stripe aparecer como instalado no Marketplace e suas ferramentas estiverem disponíveis no Canvas, a integração foi habilitada com sucesso.
    </Check>
  </Step>
</Steps>

***

## 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.

<Warning>
  Chaves de teste não processam pagamentos reais.
  Certifique-se de usar credenciais de Produção antes de entrar em produção.
</Warning>

***

## Alterando a API Key

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

<Steps>
  <Step title="Desinstalar a integração">
    Remova ou desinstale o Stripe do Marketplace.
  </Step>

  <Step title="Reinstalar">
    Repita o processo de conexão e insira a nova Secret API Key.
  </Step>
</Steps>

Após reinstalar, a integração usará as novas credenciais.

***

## Validar a integração de ponta a ponta

Com o Stripe conectado e os webhooks configurados, você pode confirmar que tudo funciona em conjunto:

<Steps>
  <Step title="Executar um pagamento de teste">
    No seu fluxo no Brain Studio, acione o nó do Stripe em **modo Teste** e conclua um pagamento usando um [cartão de teste do Stripe](https://docs.stripe.com/testing#cards).
  </Step>

  <Step title="Revisar entregas no Stripe">
    Em **Stripe → Workbench → Webhooks**, abra o destino e confirme que os eventos `payment_intent.*` foram enviados sem erros.
  </Step>

  <Step title="Confirmar o resultado no Brain Studio">
    O nó do Stripe deve ter avançado para a saída correspondente (por exemplo, **Pagamento bem-sucedido** ou **Pagamento falhou**) com base no resultado real do pagamento de teste.
  </Step>
</Steps>

<Check>
  Se o nó do Stripe avançou para a saída correta e o Stripe registrou a entrega do evento, a integração está funcionando de ponta a ponta.
</Check>

***

## Próximo passo

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

<Card title="Uso e configuração" href="/pt/guias/integracoes/pagamentos/provedores/stripe/uso-e-configuracao" icon="gear">
  Configure as ferramentas do Stripe e trate os estados de pagamento no seu fluxo.
</Card>