Skip to main content

​
¿Cuándo necesitas esto?

Lo verás cuando intentes Instalar Stripe desde Marketplace y Brain Studio te pida una API Key.
Para conectar Stripe con Brain Studio necesitas una Secret API Key, asociada a la cuenta Stripe del comercio. Esta guía explica cómo obtener:
  • Credenciales de prueba (sk_test_...)
  • Credenciales de producción (sk_live_...)
y cuándo usar cada una.
Al finalizar esta guía tendrás una Secret API Key (Test o Live) lista para instalar 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. 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.

​
Pasos para obtener credenciales

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.

​
Próximo paso

Uso y configuración

Configura las herramientas de Stripe y maneja los estados del pago en tu flujo.