Necesitas una cuenta activa en Stripe, acceso al panel de Stripe y permisos para ver/crear Claves de API y Webhooks.
No es necesario tener conocimientos técnicos avanzados.
Test (sk_test_...): para pruebas sin transacciones reales.
Live (sk_live_...): para cobros reales en producción.
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.
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.
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.
Pasar a 'Modo prueba'
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.
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
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 '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.
Opciones creación clave secreta
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.
Si la clave que copiaste comienza con sk_test_ o sk_live_, ya tienes lo necesario para instalar Stripe.
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 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.
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.
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.
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).
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.
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).
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).
URL del webhook de Jelou pegada en el endpoint de 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)
Si el destino aparece como Activo con los tres eventos y la URL de Jelou, la configuración en Stripe está completa.
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.
