> ## 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](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/kushki/obtener-credenciales.md).

> [!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.

***

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

> [tab] 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] 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] 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] 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.

> [!NOTE]
>
> Todas las rutas de instalación usan la misma configuración del proveedor. Lo que cambia es desde dónde inicias el flujo.

***

## Flujo común de instalación

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

> [!NOTE]
>
> El primer modal te pide elegir **Probar con Jelou** o **Conectar mi cuenta**.
>
> * **Probar con Jelou:** instala la pasarela en [modo prueba](https://docs.jelou.ai/guides/integraciones/pagos/modo-prueba.md), sin cuenta ni credenciales propias.
> * **Conectar mi cuenta:** usa tus credenciales de prueba o de producción. Continúa con los pasos de esta página.

**1. Elegir credenciales de prueba o producción**

Selecciona el entorno de conexión:

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

![Modal de Brain Studio paso 1 de 3 para elegir credenciales de prueba o credenciales de producción al conectar Kushki](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-conectar-seleccion-ambiente.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=144e9115652ae9234c513252f6d96454)

Paso 1 de 3: selección del ambiente para conectar Kushki

**2. Completar credenciales de Kushki**

Completa el modal (paso 2 de 3) con:

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

![Modal de Brain Studio paso 2 de 3 para ingresar llave pública, llave privada, ID de comercio y firma de webhook de Kushki](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-conectar-credenciales.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=86c08ac5d6e7786985efbb1c68ca4891)

Paso 2 de 3: credenciales requeridas para conectar Kushki

**3. 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ú |

![Modal de Brain Studio paso 3 de 3 para configurar el IVA aplicado y la moneda de cobro al conectar Kushki](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-conectar-iva.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=755e2bdaccf7ebad853b4c8fc0cec100)

Paso 3 de 3: IVA aplicado y moneda de cobro

**4. Confirmar conexión**

Presiona **Continuar** / **Conectar integración**. Brain Studio guardará la configuración y dejará **Kushki** disponible en tu workspace.

**5. 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.

***

## 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**.

> [!TIP]
>
> Usa siempre credenciales del mismo ambiente. No mezcles llaves de prueba con llaves de producción.

***

## 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:

**1. Abrir Pasar a producción**

Puedes iniciar el cambio desde cualquiera de estos puntos:

> [tab] Panel Avanzado en Canvas
>
> Abre el nodo **Kushki** en **Canvas**, ve a la pestaña **Avanzado** y selecciona **Producción**.
>
> ![Panel lateral Avanzado del nodo Kushki en Canvas con opción para pasar la integración a producción](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-pasar-a-produccion-avanzado.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=c9b5e0e495348ecfc920c36ed7ed4198)
>
> Pasar a producción desde la pestaña Avanzado del nodo Kushki

> [tab] Marketplace
>
> Abre la página de **Kushki** en **Marketplace** y presiona **Pasar a producción**.

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

**2. 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.

**3. Confirmar el cambio**

Confirma la acción. A partir de ese momento, la integración opera con credenciales de producción.

***

## 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] [Uso y configuración](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/kushki/uso-y-configuracion.md)
>
> Configura el nodo de pago y continúa el flujo según el resultado del pago en WebView.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.