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

Conecta Wompi 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 Wompi**
* La **llave pública** de Wompi
* La **llave privada** de Wompi
* El **secreto de eventos** de Wompi
* El **secreto de integridad** de Wompi
* El **porcentaje de IVA** que aplicará la operación
* Credenciales correctas según el ambiente: **Sandbox** o **Producción**

> [!TIP]
>
> Para obtener o revisar credenciales, sigue [Obtención de credenciales](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/wompi/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 Wompi 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 Wompi mientras construyes o ajustas un flujo.
>
> Ejemplos:
>
> * "Agrega pagos con Wompi a este flujo"
> * "Necesito cobrar con Wompi en este caso"
> * "Quiero procesar pagos con Wompi"
>
> Jelou Agent detecta Wompi como proveedor disponible desde Marketplace e inicia el flujo asistido de instalación.

> [tab] Marketplace
>
> Abre **Marketplace**, busca **Wompi** 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 **Wompi** 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.
>
> ![Nodo Pagos en Canvas mostrando Wompi como proveedor disponible con la opción Instalar](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/wompi-pagos-instalar.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=e475bd2c73b2b36e6af0833265b4495e)
>
> Wompi disponible para instalar desde el nodo Pagos en Canvas

> [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 Wompi 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**

Brain Studio te pedirá seleccionar si conectarás Wompi con **credenciales de prueba** o con **credenciales de producción**.

En Wompi, estas credenciales corresponden a llaves de **Sandbox** o de **Producción**.

![Modal de Brain Studio para elegir entre credenciales de prueba o credenciales de producción al conectar Wompi](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/wompi-conectar-seleccion-ambiente.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=d66c2e38a3cfce912e3588d742aa33a7)

Selección del ambiente para conectar Wompi

**2. Completar las cuatro credenciales**

Completa el modal con:

* **Llave pública**
* **Llave privada**
* **Secreto de eventos**
* **Integridad**

![Modal de Brain Studio para ingresar llave pública, llave privada, secreto de eventos e integridad de Wompi](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/wompi-conectar-credenciales.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=b448419a3a6be0d5fecfe639e061ba79)

Credenciales requeridas para conectar Wompi

**3. Configurar IVA aplicado**

Define el **IVA aplicado** que utilizará la integración durante la operación de cobro.

![Modal de Brain Studio para configurar el IVA aplicado durante la conexión de Wompi](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/wompi-conectar-iva.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=d1271dda40388456aa0123224f9624b1)

Configuración del IVA aplicado para Wompi

**4. Confirmar conexión**

Confirma la conexión. Brain Studio guardará la configuración y dejará **Wompi** disponible en tu workspace.

**5. Usar Wompi desde el nodo Pagos en Canvas**

Tras instalar, podrás usar Wompi desde el nodo **Pagos** en **Canvas**, haya empezado el flujo desde Jelou Agent, Marketplace, el nodo Pagos o un template.

***

## Credenciales Sandbox vs Producción

Wompi separa las credenciales por ambiente:

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

Las llaves y secretos tienen prefijos distintos según el ambiente:

| Ambiente | Llave pública | Llave privada | Secreto de eventos | Secreto de integridad |
| - | - | - | - | - |
| Sandbox | `pub_test_...` | `prv_test_...` | `test_events_...` | `test_integrity_...` |
| Producción | `pub_prod_...` | `prv_prod_...` | `prod_events_...` | `prod_integrity_...` |

> [!WARNING]
>
> Las credenciales de Sandbox no procesan pagos reales. Antes de operar en producción, debes conectar Wompi usando credenciales productivas.

> [!TIP]
>
> Usa siempre credenciales del mismo ambiente. No mezcles llaves o secretos de Sandbox con llaves o secretos de Producción.

***

## Pasar a producción

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

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

Puedes iniciar el cambio desde:

* El **sidebar avanzado** del nodo Wompi en **Canvas**
* La página de **Wompi** en **Marketplace**

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

![Modal de Brain Studio para pasar la integración de Wompi a producción](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/wompi-pasar-a-produccion.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=348f6350caae9eceacae72d8be45a48d)

Modal para pasar Wompi a producción

**2. Completar credenciales productivas**

Ingresa las credenciales de Producción:

* **Llave pública**
* **Llave privada**
* **Secreto de eventos**
* **Integridad**

**3. Confirmar IVA aplicado**

Revisa y confirma el **IVA aplicado** que usará la integración en producción.

**4. 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/Sandbox** 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 Wompi 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/wompi/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.