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

# Obtención de credenciales

> Obtén tu Access Token y configura los webhooks necesarios en Stripe Dashboard antes de conectar con tu cuenta existente.

> [!NOTE]
>
> Esta guía aplica **solo si eliges "Ya tengo una cuenta"** al conectar Stripe en Brain Studio.
>
> Si vas a **crear una cuenta en México** desde el flujo de instalación, no necesitas credenciales ni webhooks manuales. Ve directo a [Conectar en Brain Studio](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/stripe/conectar-en-brain-studio.md).

Esta guía cubre las dos tareas que debes completar **en Stripe Dashboard** antes de conectar con tu cuenta existente:

1. **Obtener tu Access Token** (Secret API Key Test o Live) para instalar Stripe en Marketplace.
2. **Configurar webhooks** para que Jelou reciba los eventos de pago y tu flujo funcione correctamente.

> [!TIP]
>
> Al finalizar esta guía tendrás credenciales y webhooks listos para conectar Stripe en Brain Studio.

***

## Antes de comenzar

> [!NOTE]
>
> Necesitas una **cuenta activa en Stripe**, acceso al **panel de Stripe** y permisos para ver o crear **Claves de API** y **Webhooks**.
> No es necesario tener conocimientos técnicos avanzados.

***

## Entornos en Stripe (Test vs Live)

Stripe separa los entornos por **tipo de clave**:

* **Test (`sk_test_...`)**: para pruebas sin transacciones reales.
* **Live (`sk_live_...`)**: para cobros reales en producción.

> [!WARNING]
>
> Brain Studio se conecta a Stripe usando la clave que ingreses.
> Si instalas con una clave **Test**, tu integración queda en **modo pruebas**.
> Si instalas con una clave **Live**, queda lista para **producción**.

***

## Parte 1 — Obtener tu Secret API Key

**1. Ingresar al panel de Stripe**

Inicia sesión en la cuenta Stripe del comercio.

![Dashboard principal de Stripe](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-dashboard.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=c8aaf6a7c240ded94b7ad6a2757a23d0)

Dashboard de Stripe (cuenta del comercio)

**2. Ir a Desarrolladores → Claves de API**

Hay dos formas de llegar a **Claves de API**:

* Vía configuración (ícono arriba a la derecha → Desarrolladores → Gestionar claves API)
* En el menú lateral izquierdo, busca la sección **Desarrolladores** y haz clic en **Claves de API**.

![Menú lateral con acceso directo a Desarrolladores y Claves de API](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-menu-desarrolladores.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=5aea6fffd5475ebe9acc6aa7dcb1af9a)

Acceso directo a Desarrolladores en el menú lateral

**3. Elegir el entorno (Test o Live)**

Stripe puede mostrar el modo de prueba de dos formas (según tu cuenta):

* Un acceso tipo **“Modo de prueba”** / **“Cambiar a un entorno de prueba”** desde el selector de cuenta.
* Una **barra superior** indicando que estás usando datos de prueba.

![Selector de cuenta con opción para cambiar a entorno de prueba](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-toggle-modo-prueba.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=959fe01a5d51541c61dd8d9bf7d6f765)

Pasar a 'Modo prueba'

> [!NOTE]
>
> Si tu cuenta está en **modo Live**, es normal que en Claves de API veas claves con `live`.
> Para obtener claves **Test**, debes entrar a **Modo de prueba** y volver a esta misma pantalla.

![Opción para salir del modo de prueba en Stripe](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-salir-modo-prueba.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=690d636077c01cb359d8a99d35276408)

Salir del 'Modo prueba'

**4. Crear (o copiar) tu Secret API Key**

En **Claves de API**, verás dos tipos de claves:

* **Publishable key (`pk_...`)** → NO sirve para instalar Stripe en Brain Studio
* **Secret key (`sk_...`)** → SÍ es la que necesitas

> [!WARNING]
>
> En Brain Studio debes usar siempre una **Secret API Key** (`sk_test_...` o `sk_live_...`).
> No uses la Publishable Key (`pk_...`).

Si ya tienes una **Secret key** lista para usar, puedes copiarla.
Si necesitas crear una nueva, haz clic en **Crear clave secreta**.

![Sección de claves standard y botón crear clave secreta](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-crear-clave-secreta.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=e8c8e655517ce238a7fbd097e31f7082)

Sección 'Claves Standard' con botón 'Crear clave secreta'

**5. Elegir el tipo de clave (recomendado: Standard)**

Al crear una clave, Stripe suele mostrar opciones como:

* **Cómo crear tu integración** (clave standard / acceso completo)
* **Proporciono esta clave a otro sitio web** (Stripe sugiere clave restringida)

Para Marketplace (BYOK) y para evitar fricción, **recomendamos usar una clave standard**.

![Modal de Stripe para crear una clave secreta con opciones](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-modal-crear-clave.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=a5bd7d98fd22a3333e3597e780b3897c)

Opciones creación clave secreta

> [!NOTE]
>
> Stripe puede recomendar claves restringidas para compartir con terceros.
> En Jelou, la clave se guarda de forma segura a nivel de plataforma (no se expone al usuario final).
> Si necesitas control adicional, revisa la sección **Claves restringidas (opcional)** al final de esta guía.

> [!TIP]
>
> Si la clave que copiaste comienza con `sk_test_` o `sk_live_`, ya tienes lo necesario para instalar Stripe.

![Confirmación de clave secreta creada en Stripe](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-clave-creada-confirmacion.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=63fd4bcf3d0e8f3c2d92922561909843)

Entrega de clave secreta

**6. Usar la Secret API Key en Brain Studio**

Durante la instalación desde **Marketplace**, Brain Studio te pedirá una única credencial: **API Key**.

Pega tu Secret API Key (`sk_test_...` o `sk_live_...`) y confirma.

![Modal de Brain Studio solicitando API Key para instalar Stripe](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-brain-studio-modal-credenciales.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=c2349317b7a162d5f6687bf960150318)

Modal de instalación en Brain Studio solicitando 'API Key' para Stripe

Una vez configurado:

* Los cobros se procesan **directamente** en la cuenta Stripe del comercio.
* Jelou **no custodia fondos**.
* El resultado del pago vuelve al flujo para continuar según el estado real.

***

## Test vs Live en Brain Studio

* Si instalas con `sk_test_...`, operas en **modo pruebas**.
* Si instalas con `sk_live_...`, operas en **producción**.

> [!WARNING]
>
> Para cambiar de **Test → Live** (o viceversa), por ahora debes:
> **desinstalar Stripe** en Marketplace y **volver a instalar** con la nueva clave.

***

## Claves restringidas (opcional)

Stripe permite crear **Restricted Keys** (suelen verse como `rk_...`) con permisos específicos.

Puedes usar una clave restringida si tu organización requiere mayor control, pero debes asegurarte de habilitar los permisos necesarios para que Stripe funcione correctamente en Brain Studio.

> [!TIP]
>
> Si quieres profundizar, revisa la documentación oficial de Stripe sobre API keys:
> [https://docs.stripe.com/keys](https://docs.stripe.com/keys)

***

## Resolución de problemas

> [accordion] No encuentro el 'Modo de prueba' o 'Ver datos de prueba'
>
> En algunas cuentas de Stripe el acceso a Test aparece en el **selector de cuenta** (arriba a la izquierda) como:
>
> * **Cambiar a un entorno de prueba**
> * **Modo de prueba**
> * **Administrar entornos de prueba**
>
> Si ya estás en modo prueba, suele aparecer una **barra superior** indicando que estás usando datos de prueba.

> [accordion] Copié una clave que comienza con `pk_` y Brain Studio no la acepta
>
> Estás usando una **Publishable key** (`pk_...`).
>
> Vuelve a **Desarrolladores → Claves de API** y copia una **Secret key** (`sk_...`).

> [accordion] Creé una clave y no la puedo volver a ver completa
>
> Stripe muestra la clave completa **solo una vez** al momento de crearla.
>
> Si no la guardaste:
>
> * crea una nueva clave
>
> * guárdala en un lugar seguro (password manager / secret vault)
>
> > [!NOTE]
> >
> > Esto es comportamiento normal de Stripe para proteger claves secretas.

***

## Buenas prácticas

> [accordion] Seguridad de tu Secret API Key
>
> * No compartas tu `sk_...` por chat o correo.
> * Guárdala en un gestor de contraseñas o bóveda de secretos.
> * Si sospechas exposición, rótala desde el panel de Stripe y reinstala Stripe en Brain Studio con la nueva clave.

> [accordion] Uso por entorno
>
> * Usa `sk_test_...` para pruebas internas y QA.
> * Antes de salir a producción, instala con `sk_live_...` y valida un pago real end-to-end.

***

***

## Parte 2 — Configurar webhooks en Stripe (obligatorio)

Jelou necesita que Stripe **envíe eventos de pago** a la plataforma para alinear el resultado del cobro con tu flujo en Brain Studio. Eso se configura **en Stripe Dashboard**: creas un endpoint de webhook y eliges los eventos indicados más abajo.

> [!WARNING]
>
> Sin webhooks correctos, el pago puede completarse en Stripe y, aun así, el flujo en Brain Studio puede quedar **inconsistente** (por ejemplo, pendiente o sin avanzar a la salida esperada del nodo).

> [!NOTE]
>
> Stripe distingue **modo prueba (Test)** y **modo producción (Live)**. Configura **un webhook en cada modo** si vas a usar ambos. La **Secret API Key** que instalarás en Marketplace (`sk_test_...` o `sk_live_...`) debe corresponder al mismo modo que el webhook que estés configurando en el panel.

### Abrir Developers, Workbench y Webhooks

**1. Abrir Developers**

En **Stripe Dashboard**, localiza la sección **Developers** (en algunas cuentas aparece en la barra inferior).

**2. Abrir Workbench**

Abre el **Workbench** desde el acceso que ofrece Stripe (por ejemplo, el icono de flecha hacia arriba en la barra de desarrolladores).

**3. Ir a la pestaña Webhooks**

Dentro del Workbench, selecciona la pestaña **Webhooks** y crea un **nuevo destino** o **nuevo endpoint** (el nombre exacto puede variar según la versión del panel).

![Stripe Dashboard: Workbench con la pestaña Webhooks visible](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-webhook-workbench.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=6043fdde8a233e45bd8138e5793dfc45)

Workbench de Stripe: acceso a la pestaña Webhooks

### Elegir eventos y tipo de destino

**1. Seleccionar eventos**

Cuando el asistente te pida qué eventos notificar, busca `payment_intent` y marca **solo** estos tres:

* `payment_intent.succeeded`
* `payment_intent.requires_action`
* `payment_intent.payment_failed`

**2. Origen de los eventos**

Si Stripe pregunta el origen, elige **Tu cuenta**.

**3. Tipo de destino**

Elige **Webhook endpoint** (URL HTTPS), no otros conectores como EventBridge.

![Lista de eventos de Stripe con payment\_intent.succeeded, requires\_action y payment\_failed marcados](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-webhook-events.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=e33015cd60fb2aa0f272d2d6701c176c)

Eventos payment\_intent seleccionados en el asistente de Stripe

### URL del endpoint por entorno

Copia la URL que corresponda al modo activo en el Dashboard (barra o indicador de **modo prueba** / **live**).

> [tab] Modo prueba (Test)
>
> ```text theme={null}
> https://chat-payments.jelou.dev/link-webhook?provider=STRIPE
> ```

> [tab] Modo producción (Live)
>
> ```text theme={null}
> https://chat-payments.jelou.ai/link-webhook?provider=STRIPE
> ```

**1. Pegar la URL y guardar**

En el campo de URL del endpoint, pega la dirección del tab anterior según el modo en que estés trabajando. Revisa el resumen: deben figurar los **tres eventos** y el tipo **webhook**. **Crea** o **guarda** el destino.

**2. Repetir en el otro modo (si aplica)**

Si usas Test y Live, vuelve a crear el endpoint en el otro modo del Dashboard con la otra URL (`jelou.dev` para prueba, `jelou.ai` para producción).

![Formulario de Stripe para crear destino de webhook con la URL de Jelou y nombre del destino](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/stripe-webhook-endpoint.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=6e235ccd94e92d07a8a918f3aae116ef)

URL del webhook de Jelou pegada en el endpoint de Stripe

### Verificar el endpoint en Stripe

Antes de continuar, confirma en el panel que el destino quedó correctamente registrado:

**1. Revisar el listado de destinos**

En **Stripe → Workbench → Webhooks**, el endpoint recién creado debe aparecer con estado **Activo**.

**2. Confirmar eventos y URL**

Abre el detalle del destino y verifica que:

* Escucha exactamente los **tres eventos** (`payment_intent.succeeded`, `payment_intent.requires_action`, `payment_intent.payment_failed`)
* La URL apunta a la dirección de Jelou correcta para tu entorno (`jelou.dev` para Test, `jelou.ai` para Live)

> [!TIP]
>
> Si el destino aparece como Activo con los tres eventos y la URL de Jelou, la configuración en Stripe está completa.

> [!TIP]
>
> Si algo no cuadra, revisa en este orden: que el modo del Dashboard (Test vs Live) coincida con la URL, que los tres eventos estén seleccionados y que la URL no tenga espacios ni caracteres de más.

***

## Próximo paso

> [card] [Conectar en Brain Studio](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/stripe/conectar-en-brain-studio.md)
>
> Instala Stripe en Marketplace y conecta tu cuenta usando tu Secret API Key.


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