> ## 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 Conekta en Brain Studio, configura sus credenciales y usa el nodo de pago en tus flujos.

Conecta Conekta para habilitar el proveedor en tu workspace y dejar disponible el nodo de pago en Brain Studio con experiencia de **WebView embebido**.

***

## Antes de comenzar

Asegúrate de tener:

* Una **cuenta activa de Conekta**
* La **llave pública** de Conekta
* La **llave privada** de Conekta
* El **porcentaje de IVA** que aplicará la operación
* El **webhook** configurado en Conekta para el ambiente que vas a conectar
* Credenciales correctas según el ambiente: **prueba** o **producción**

<Tip>
  Para obtener o revisar credenciales y webhooks, sigue [Obtención de credenciales](/guides/integraciones/pagos/proveedores/conekta/obtener-credenciales).
</Tip>

<Warning>
  Para que el checkout se abra dentro de WhatsApp como WebView embebido, la cuenta debe ser **WhatsApp Business verificada**.

  Si no está verificada, el checkout se abrirá en el navegador externo del dispositivo.
</Warning>

***

## Formas de iniciar la instalación

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

<Tabs>
  <Tab title="Jelou Agent">
    Pídele a Jelou Agent que agregue pagos con Conekta mientras construyes o ajustas un flujo.

    Ejemplos:

    * "Agrega pagos con Conekta a este flujo"
    * "Necesito cobrar con Conekta en este caso"
    * "Quiero procesar pagos con Conekta"

    Jelou Agent detecta Conekta como proveedor disponible desde Marketplace e inicia el flujo asistido de instalación.
  </Tab>

  <Tab title="Marketplace">
    Abre **Marketplace**, busca **Conekta** en **Pagos & Procesamiento** o usa el buscador.

    Luego presiona **Conectar** o **Instalar** para iniciar el flujo de instalación.
  </Tab>

  <Tab title="Nodo Pagos">
    Desde la barra de herramientas de **Canvas**, abre el nodo **Pagos**.

    Dentro del nodo **Pagos**, puedes ver **Conekta** 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>

  <Tab title="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 Conekta como parte del flujo de configuración.
  </Tab>
</Tabs>

<Note>
  Todas las rutas de instalación usan la misma configuración del proveedor. Lo que cambia es desde dónde inicias el flujo.
</Note>

***

## Flujo común de instalación

Independientemente del punto de entrada, el proceso compartido es el siguiente.

<Steps>
  <Step title="Elegir credenciales de prueba o producción">
    Brain Studio te pedirá seleccionar si conectarás Conekta con **credenciales de prueba** o con **credenciales de producción**.

    <Frame caption="Paso 1 de 3: selección del ambiente para conectar Conekta">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/conekta-conectar-seleccion-ambiente.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=3af13acf44e2efb0379ea88f65d4017b" alt="Modal de Brain Studio paso 1 de 3 para elegir credenciales de prueba o credenciales de producción al conectar Conekta" width="1024" height="477" data-path="assets/images/integraciones/pagos/conekta-conectar-seleccion-ambiente.png" />
    </Frame>
  </Step>

  <Step title="Completar llave pública y llave privada">
    Completa el modal con:

    * **Llave pública**
    * **Llave privada**

    <Frame caption="Paso 2 de 3: credenciales requeridas para conectar Conekta">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/conekta-conectar-credenciales.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=aa61c8acee434c8523199b2d52d74217" alt="Modal de Brain Studio paso 2 de 3 para ingresar la llave pública y la llave privada de Conekta" width="1024" height="611" data-path="assets/images/integraciones/pagos/conekta-conectar-credenciales.png" />
    </Frame>
  </Step>

  <Step title="Configurar IVA y moneda de cobro">
    Define el **IVA aplicado** y confirma la **moneda de cobro**.

    Para Conekta México, la moneda suele ser **MXN — Peso mexicano**.

    <Frame caption="Paso 3 de 3: IVA aplicado y moneda de cobro">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/conekta-conectar-iva.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=ee816f07339baa3c9f33e539b80f9003" alt="Modal de Brain Studio paso 3 de 3 para configurar el IVA aplicado y la moneda de cobro MXN al conectar Conekta" width="1024" height="614" data-path="assets/images/integraciones/pagos/conekta-conectar-iva.png" />
    </Frame>
  </Step>

  <Step title="Confirmar conexión">
    Presiona **Conectar integración**. Brain Studio guardará la configuración y dejará **Conekta** disponible en tu workspace.
  </Step>

  <Step title="Usar Conekta desde el nodo Pagos en Canvas">
    Tras instalar, podrás usar Conekta desde el nodo **Pagos** en **Canvas**, haya empezado el flujo desde Jelou Agent, Marketplace, el nodo Pagos o un template.
  </Step>
</Steps>

***

## Credenciales de prueba vs producción

Conekta separa las credenciales por ambiente:

* **Prueba:** credenciales para pruebas sin dinero real.
* **Producción:** credenciales para procesar pagos reales.

<Warning>
  Las credenciales de prueba no procesan pagos reales. Antes de operar en producción, debes conectar Conekta usando credenciales productivas o usar **Pasar a producción**.
</Warning>

<Tip>
  Usa siempre credenciales del mismo ambiente. No mezcles llaves de prueba con llaves de producción.
</Tip>

***

## Pasar a producción

Si instalaste Conekta con credenciales de **desarrollo/prueba**, puedes usar el nodo de pago para pruebas. Para operar con pagos reales:

<Steps>
  <Step title="Abrir Pasar a producción">
    Puedes iniciar el cambio desde cualquiera de estos puntos:

    <Tabs>
      <Tab title="Panel Avanzado en Canvas">
        Abre el nodo **Conekta** en **Canvas**, ve a la pestaña **Avanzado** del panel lateral y selecciona **Producción**.

        <Frame caption="Pasar a producción desde la pestaña Avanzado del nodo Conekta">
          <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/conekta-pasar-a-produccion-avanzado.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=e37f5dda76e3927684bc8426ce436895" alt="Panel lateral Avanzado del nodo Conekta en Canvas con opción para pasar la integración a producción" width="1024" height="592" data-path="assets/images/integraciones/pagos/conekta-pasar-a-produccion-avanzado.png" />
        </Frame>
      </Tab>

      <Tab title="Marketplace">
        Abre la página de **Conekta** en **Marketplace** y presiona **Pasar a producción**.

        <Frame caption="Pasar a producción desde la página de Conekta en Marketplace">
          <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/conekta-pasar-a-produccion-marketplace.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=e112790ed41ee263affab57f61837b74" alt="Página de Conekta en Marketplace con el botón Pasar a producción" width="582" height="440" data-path="assets/images/integraciones/pagos/conekta-pasar-a-produccion-marketplace.png" />
        </Frame>
      </Tab>
    </Tabs>

    En ambos casos se abre el mismo modal para pasar la integración a producción.
  </Step>

  <Step title="Completar credenciales productivas">
    Ingresa las credenciales de producción:

    * **Llave pública**
    * **Llave privada**

    <Frame caption="Modal para pasar Conekta a producción">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/conekta-pasar-a-produccion-modal.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=517b7f44aedf3572a5fc696b8a43fc8e" alt="Modal de Brain Studio para pasar Conekta a producción ingresando llave pública y llave privada productivas" width="1024" height="625" data-path="assets/images/integraciones/pagos/conekta-pasar-a-produccion-modal.png" />
    </Frame>

    <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 Conekta.
    </Warning>
  </Step>

  <Step title="Confirmar el cambio">
    Confirma la acción. A partir de ese momento, la integración opera con credenciales de producción.
  </Step>
</Steps>

***

## Cambiar credenciales

* Para pasar de **desarrollo/prueba** a **producción** con la misma instalación, usa la sección **Pasar a producción**.
* Para **rotar credenciales** o **reemplazar la configuración**, desconecta Conekta 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 title="Uso y configuración" href="/guides/integraciones/pagos/proveedores/conekta/uso-y-configuracion" icon="gear">
  Configura el nodo de pago y continúa el flujo según el resultado del pago en WebView.
</Card>
