> ## 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 en Brain Studio con tu Access Token o creando una cuenta en México desde el flujo guiado de registro.

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

Puedes instalar la integración de dos formas:

* **Ya tengo una cuenta:** conecta con tu **Access Token** de Stripe (prueba o producción).
* **Crear cuenta en Stripe:** registro guiado disponible **solo en México**. Al completarlo, Brain Studio instala Stripe automáticamente sin pedir credenciales.

***

## Antes de comenzar

> [tab] Ya tengo una cuenta
>
> Asegúrate de tener:
>
> * Una **cuenta activa en Stripe**
>
> * Tu **Access Token** (`sk_test_...` o `sk_live_...`) del entorno que vas a conectar
>
> * Los **webhooks** configurados en Stripe Dashboard para que Jelou reciba eventos de pago
>
> > [!TIP]
> >
> > Para obtener el Access Token y configurar webhooks, sigue [Obtención de credenciales](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/stripe/obtener-credenciales.md).

> [tab] Crear cuenta en Stripe
>
> Solo necesitas:
>
> * Operar en **México**
>
> * Definir si iniciarás en **credenciales de prueba** o **credenciales de producción**
>
> > [!NOTE]
> >
> > No necesitas credenciales previas ni configurar webhooks manualmente. Brain Studio gestiona la conexión cuando completas el registro en Stripe.

***

## Formas de iniciar la instalación

Puedes iniciar la instalación de Stripe desde distintos puntos de Brain Studio. Todas las rutas usan la misma configuración del proveedor.

> [tab] Jelou Agent
>
> Pídele a Jelou Agent que agregue pagos con Stripe mientras construyes o ajustas un flujo.
>
> Ejemplos:
>
> * "Agrega pagos con Stripe a este flujo"
> * "Necesito cobrar con Stripe en este caso"
>
> Jelou Agent detecta Stripe como proveedor disponible desde Marketplace e inicia el flujo asistido de instalación.

> [tab] Marketplace
>
> Abre **Marketplace**, busca **Stripe** en **Pagos & Procesamiento** o usa el buscador.
>
> Luego presiona **Conectar** o **Instalar** para iniciar el flujo de instalación.
>
> ![Stripe en el catálogo de integraciones de Marketplace](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-marketplace-catalogo.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=bff7273e09084af54e7da4d74ff680ab)
>
> Stripe disponible en el catálogo de Marketplace

> [tab] Nodo Pagos
>
> Desde la barra de herramientas de **Canvas**, abre el nodo **Pagos**.
>
> Dentro del nodo **Pagos**, puedes ver **Stripe** como proveedor disponible. Si todavía no está conectado, presiona **Instalar** para iniciar el mismo flujo de conexión usado por Marketplace, Jelou Agent y templates.

> [tab] Templates
>
> Algunos templates de Brain Studio pueden incluir configuración de pagos.
>
> Durante la creación del template, Brain Studio puede pedirte elegir un proveedor de pago y conectar Stripe como parte del flujo de configuración.

> [!NOTE]
>
> Todas las rutas de instalación usan la misma configuración del proveedor. Lo que cambia es desde dónde inicias el flujo.

***

## Flujo común de instalación

Independientemente del punto de entrada, el primer paso del modal es el mismo.

> [!NOTE]
>
> El primer modal te pide elegir **Probar con Jelou** o **Conectar mi cuenta**.
>
> * **Probar con Jelou:** instala la pasarela en [modo prueba](https://docs.jelou.ai/guides/integraciones/pagos/modo-prueba.md), sin cuenta ni credenciales propias.
> * **Conectar mi cuenta:** usa tus credenciales de prueba o de producción. Continúa con los pasos de esta página.

**1. Elegir tipo de cuenta y entorno**

Brain Studio te pregunta si **ya tienes una cuenta de Stripe** o si necesitas **crear una**.

También debes seleccionar el entorno de conexión:

* **Credenciales de prueba** — para desarrollo y QA sin transacciones reales.
* **Credenciales de producción** — para cobros reales.

> [!NOTE]
>
> La opción **Crear cuenta en Stripe** muestra el distintivo **Solo México** y está disponible únicamente para comercios en ese país.

![Modal Conectar Stripe paso 1 con opciones Ya tengo una cuenta o Crear cuenta en Stripe Solo México y selección de credenciales de prueba o producción](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-conectar-paso1-cuenta-ambiente.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=a6cf9f870221ff74c31c7ab852c9e142)

Paso 1: elige tipo de cuenta y entorno de conexión

Presiona **Continuar** cuando hayas completado ambas selecciones.

A partir de aquí, el flujo se divide según la opción elegida.

> [tab] Ya tengo una cuenta
>
> **1. Ingresar tu Access Token**
>
> Pega tu **Access Token** correspondiente al entorno seleccionado en el paso anterior.
>
> El campo acepta claves con formato `sk_test_...` (prueba) o `sk_live_...` (producción).
>
> Usa el enlace **Cómo obtener credenciales** del modal si necesitas ayuda para obtenerlo o configurar webhooks en Stripe Dashboard.
>
> > [!NOTE]
> >
> > En Stripe, el Access Token corresponde a la **Secret API Key**. No uses la Publishable Key (`pk_`).
>
> > [!WARNING]
> >
> > El Access Token debe corresponder al entorno elegido en el paso 1. Si seleccionaste **Credenciales de prueba**, usa un token de prueba; si elegiste **Credenciales de producción**, usa un token productivo.
>
> ![Modal Conectar Stripe paso 2 de 2 con campo Access Token para conectar la integración](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-byok-paso2-token.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=f47566127b00b86141c772d7bdb4e01d)
>
> Paso 2 de 2: ingresa tu Access Token
>
> **2. Confirmar conexión**
>
> Presiona **Conectar integración**. Brain Studio validará el token y dejará **Stripe** disponible en tu workspace.
>
> > [!TIP]
> >
> > Si Stripe aparece como instalado en Marketplace y sus herramientas están disponibles en Canvas, la integración quedó habilitada correctamente.

> [tab] Crear cuenta en Stripe
>
> **1. Confirmar generación del link de registro**
>
> Brain Studio te muestra un resumen del registro que completarás en Stripe.
>
> El texto varía según el entorno elegido:
>
> * **Prueba:** te ayudará a completar el registro para probar pagos en desarrollo.
> * **Producción:** te guiará para validar tu cuenta productiva en Stripe.
>
> Si aún no tienes cuenta, podrás crearla durante el registro.
>
> Presiona **Generar link de registro** para continuar.
>
> ![Modal Conectar Stripe en México paso 2 de 3 para generar link de registro en desarrollo](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-crear-cuenta-paso2-confirmacion.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=6194aac336a6e1faf80dc2b9508d0619)
>
> Paso 2 de 3: confirma la generación del link de registro
>
> **2. Copiar o abrir el link de registro**
>
> Brain Studio genera un **link de registro** único para tu sesión.
>
> * Copia el link con el botón de copiar.
>
> * O presiona **Abrir registro en Stripe** para ir directamente al formulario.
>
> > [!WARNING]
> >
> > El link tiene tiempo de expiración limitado (aproximadamente 30 minutos). Si expira, vuelve a iniciar el flujo de instalación.
>
> ![Modal Conectar Stripe en México paso 3 de 3 con link de registro copiable y botón Abrir registro en Stripe](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-crear-cuenta-paso3-link.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=5d1513be484093cf0e1dfb5d3c23ad0c)
>
> Paso 3 de 3: copia o abre el link de registro
>
> **3. Completar el registro en Stripe**
>
> En la pantalla de Stripe, completa los datos solicitados (correo, teléfono y demás información requerida).
>
> Durante el registro en modo prueba, Stripe puede ofrecerte atajos con datos de test.
>
> ![Pantalla de registro en Stripe con branding de Jelou AI para verificar datos personales](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-registro-externo.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=da477f1030db04b49c6c7b8912546116)
>
> Registro en Stripe: completa tus datos personales
>
> > [!TIP]
> >
> > Cuando termines el registro, Brain Studio detecta que la cuenta quedó activa e **instala Stripe automáticamente**. No necesitas volver a ingresar credenciales.

***

## Credenciales de prueba vs producción

> [!WARNING]
>
> Las credenciales de prueba no procesan pagos reales. Antes de operar en producción, debes conectar o pasar la integración usando credenciales productivas.

| Camino | Prueba | Producción |
| - | - | - |
| **Ya tengo una cuenta** | Access Token `sk_test_...` + webhooks en modo Test | Access Token `sk_live_...` + webhooks en modo Live |
| **Crear cuenta en Stripe** | Link de registro para desarrollo | Link de registro para producción |

> [!TIP]
>
> Si conectaste Stripe en prueba, configura el nodo en **Desarrollo** al probar tu flujo. Revisa [Uso y configuración](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/stripe/uso-y-configuracion.md).

***

## Pasar a producción

Si instalaste Stripe en **desarrollo**, puedes pasar a producción cuando estés listo. El modal te pregunta si ya tienes una cuenta productiva o si necesitas crear una nueva en México.

**1. Abrir Pasar a producción**

Puedes iniciar el cambio desde:

* El **sidebar avanzado** del nodo Stripe en **Canvas** (pestaña **Avanzado** → **Producción**)
* La página de **Stripe** en **Marketplace**

En ambos casos se abre el mismo modal.

**2. Elegir cómo conectar la cuenta productiva**

Selecciona una de las dos opciones:

* **Conectar cuenta existente:** ingresa tu **Access Token productivo** (`sk_live_...`). Requiere haber configurado webhooks en modo Live en Stripe Dashboard.
* **Conectar cuenta nueva:** completa el **registro adicional en Stripe** para validar tu cuenta. Disponible **solo en México**. Brain Studio genera un nuevo link de registro productivo.

![Modal Pasar a producción de Stripe con opciones Conectar cuenta existente y Conectar cuenta nueva Solo México](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-pasar-a-produccion.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=807ba044b4920a90b2e3ca399f0de6cc)

Pasar a producción: elegir cuenta existente o crear cuenta nueva en México

> [!WARNING]
>
> En producción, cada transacción tiene un costo de **\$0.10 USD** por pago, descontado de tu saldo en Brain Studio, además de las tarifas de Stripe.

**3. Completar el flujo elegido**

* **Cuenta existente:** pega tu Access Token productivo y confirma.
* **Cuenta nueva:** genera el link, completa el registro en Stripe y espera la confirmación automática en Brain Studio.

**4. Confirmar el cambio**

Una vez completado, la integración opera en **Producción**.

***

## Cambiar credenciales

* Para pasar de **prueba** a **producción** con la misma instalación, usa **Pasar a producción**.
* Para **rotar credenciales** o **reemplazar la configuración**, desconecta Stripe y vuelve a instalarlo siguiendo el **flujo común de instalación** de esta página.

***

## Próximo paso

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

> [card] [Uso y configuración](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/stripe/uso-y-configuracion.md)
>
> Configura el nodo de pago, el ambiente y la experiencia de cobro en tu flujo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.