Saltar al contenido principal

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.

Esta guía cubre las dos tareas que debes completar en Stripe Dashboard antes de conectar con Brain Studio:
  1. Obtener tu 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.
Al finalizar esta guía tendrás credenciales y webhooks listos para conectar Stripe en Brain Studio.

​
Antes de comenzar

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.

​
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.
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
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
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
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
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 de claves standard y 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
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.
Confirmación de clave secreta creada en Stripe
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
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.
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.
Si quieres profundizar, revisa la documentación oficial de Stripe sobre API keys: https://docs.stripe.com/keys

​
Resolución de problemas

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.
Estás usando una Publishable key (pk_...).Vuelve a Desarrolladores → Claves de API y copia una Secret key (sk_...).
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)
Esto es comportamiento normal de Stripe para proteger claves secretas.

​
Buenas prácticas

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

​
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

​
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

​
URL del endpoint por entorno

Copia la URL que corresponda al modo activo en el Dashboard (barra o indicador de modo prueba / live). 
https://chat-payments.jelou.dev/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

​
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)
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.

​
Próximo paso

Conectar en Brain Studio

Instala Stripe en Marketplace y conecta tu cuenta usando tu Secret API Key.