> ## 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 en Brain Studio

> Instala Stripe desde Marketplace en Brain Studio usando tu Secret API Key.

Conecta Stripe desde **Marketplace** para habilitar el proveedor en tu workspace y dejar disponibles sus herramientas de pago en Brain Studio.

Stripe se conecta bajo el modelo **BYOK (Bring Your Own Key)**, utilizando tu propia cuenta.

***

## Antes de comenzar

Asegúrate de haber completado estos dos pasos en Stripe Dashboard:

* Tener una **Secret API Key (`sk_`)** (Test o Producción)
* Haber **configurado los webhooks** para que Jelou reciba eventos de pago

<Tip>
  Si aún no has hecho esto, sigue primero la guía
  [Configurar tu cuenta en Stripe](/guides/integraciones/pagos/proveedores/stripe/configurar-en-stripe).
</Tip>

***

## Conectar desde Marketplace

<Steps>
  <Step title="Abrir Marketplace">
    En Brain Studio, ingresa a **Marketplace** desde el menú lateral.

    Puedes encontrar Stripe dentro de la categoría\
    **Pagos & Procesamiento** o usando el buscador.

    <Frame caption="Stripe disponible en el catálogo de 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 en el catálogo de integraciones de Marketplace" width="2048" height="954" data-path="assets/images/integraciones/pagos/stripe-marketplace-catalogo.png" />
    </Frame>
  </Step>

  <Step title="Seleccionar Stripe">
    Haz clic en la tarjeta de **Stripe** para abrir su detalle.
  </Step>

  <Step title="Presionar Instalar (o Conectar)">
    Haz clic en **Instalar**.

    En algunas versiones del UI el botón puede mostrarse como **Conectar**.\
    Ambos cumplen la misma función: iniciar la conexión del proveedor.
  </Step>

  <Step title="Ingresar tu Secret API Key">
    Se abrirá un modal solicitando una **API Key**.

    <Frame caption="Ingreso de Secret API Key de 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 ingresar Secret API Key de Stripe" width="1910" height="684" data-path="assets/images/integraciones/pagos/stripe-modal-credenciales.png" />
    </Frame>

    Pega tu **Secret API Key (`sk_test_...` o `sk_live_...`)** y confirma la instalación.

    <Warning>
      No utilices la **Publishable Key (`pk_`)**.\
      Brain Studio requiere una **Secret Key (`sk_`)** para operar correctamente.
    </Warning>
  </Step>

  <Step title="Integración disponible para su uso">
    Brain Studio validará la clave y conectará Stripe a tu workspace.

    <Check>
      Si Stripe aparece como instalada en Marketplace y sus herramientas están disponibles en el Canvas, la integración quedó habilitada correctamente.
    </Check>
  </Step>
</Steps>

***

## Usar credenciales de Test vs Producción

Puedes conectar la integración con:

* **Secret Key de Test (`sk_test_`)** → Para ambientes de prueba o QA.
* **Secret Key de Producción (`sk_live_`)** → Para procesar pagos reales.

El entorno que utilices dependerá de la clave ingresada al momento de instalar.

<Warning>
  Las claves de Test no procesan pagos reales.\
  Asegúrate de usar credenciales de Producción antes de salir a operación.
</Warning>

***

## Cambiar la API Key

Si necesitas pasar de **Test a Producción** (o rotar credenciales):

<Steps>
  <Step title="Desinstalar la integración">
    Elimina o desinstala Stripe desde Marketplace.
  </Step>

  <Step title="Instalar nuevamente">
    Repite el proceso de conexión e ingresa la nueva Secret API Key.
  </Step>
</Steps>

Una vez reinstalada, la integración utilizará las nuevas credenciales.

***

## Validar la integración end-to-end

Con Stripe conectado y los webhooks configurados, puedes confirmar que todo funciona de forma completa:

<Steps>
  <Step title="Lanzar un pago de prueba">
    Desde tu flujo en Brain Studio, dispara el nodo de Stripe en **modo Test** y completa un pago usando una [tarjeta de prueba de Stripe](https://docs.stripe.com/testing#cards).
  </Step>

  <Step title="Revisar entregas en Stripe">
    En **Stripe → Workbench → Webhooks**, abre el destino y confirma que los eventos `payment_intent.*` se enviaron sin errores.
  </Step>

  <Step title="Confirmar el resultado en Brain Studio">
    El nodo de Stripe debe haber avanzado a la salida correspondiente (por ejemplo, **Pago exitoso** o **Pago fallido**) según el resultado real del pago de prueba.
  </Step>
</Steps>

<Check>
  Si el nodo de Stripe avanzó a la salida correcta y Stripe registró la entrega del evento, la integración está funcionando de extremo a extremo.
</Check>

***

## Próximo paso

Una vez conectada la integración, continúa con:

<Card title="Uso y configuración" href="/guides/integraciones/pagos/proveedores/stripe/uso-y-configuracion" icon="gear">
  Configura las herramientas de Stripe y maneja los estados del pago en tu flujo.
</Card>