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

Conecta Kushki 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 Kushki**
* La **llave pública** de Kushki
* La **llave privada** de Kushki
* El **ID de comercio** de Kushki
* La **firma de webhook** de Kushki
* El **porcentaje de IVA** que aplicará la operación
* La **moneda de cobro** acorde al país de tu cuenta
* El **webhook** solicitado a Kushki con la URL `https://chat-payments.jelou.ai/kushki-webhook`
* Credenciales correctas según el ambiente: **prueba** o **producción**

<Tip>
  Para obtener o revisar credenciales y solicitar el webhook a Kushki, sigue [Obtención de credenciales](/guides/integraciones/pagos/proveedores/kushki/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 Kushki 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 Kushki mientras construyes o ajustas un flujo.

    Ejemplos:

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

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

  <Tab title="Marketplace">
    Abre **Marketplace**, busca **Kushki** 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 **Kushki** 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 Kushki 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">
    Selecciona el entorno de conexión:

    * **Credenciales de prueba**
    * **Credenciales de producción**

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

  <Step title="Completar credenciales de Kushki">
    Completa el modal (paso 2 de 3) con:

    * **Llave pública**
    * **Llave privada**
    * **ID de comercio**
    * **Firma de webhook**

    <Frame caption="Paso 2 de 3: credenciales requeridas para conectar Kushki">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-conectar-credenciales.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=70f1a1a8571cc60ea81b75dee4b538df" alt="Modal de Brain Studio paso 2 de 3 para ingresar llave pública, llave privada, ID de comercio y firma de webhook de Kushki" width="1238" height="1016" data-path="assets/images/integraciones/pagos/kushki-conectar-credenciales.png" />
    </Frame>
  </Step>

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

    Las monedas disponibles son:

    | Moneda                       | País habitual |
    | ---------------------------- | ------------- |
    | `USD` — Dólar estadounidense | Ecuador       |
    | `COP` — Peso colombiano      | Colombia      |
    | `CLP` — Peso chileno         | Chile         |
    | `MXN` — Peso mexicano        | México        |
    | `PEN` — Sol peruano          | Perú          |

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

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

  <Step title="Usar Kushki desde el nodo Pagos en Canvas">
    Tras instalar, podrás usar Kushki 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

Kushki 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 Kushki 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 Kushki 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 **Kushki** en **Canvas**, ve a la pestaña **Avanzado** y selecciona **Producción**.

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

      <Tab title="Marketplace">
        Abre la página de **Kushki** en **Marketplace** y presiona **Pasar a producción**.
      </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 mismas credenciales que en la instalación, pero del ambiente de producción:

    * **Llave pública**
    * **Llave privada**
    * **ID de comercio**
    * **Firma de webhook**

    <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 Kushki.
    </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 Kushki 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/kushki/uso-y-configuracion" icon="gear">
  Configura el nodo de pago y continúa el flujo según el resultado del pago en WebView.
</Card>
