> ## 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](/guides/integraciones/pagos/proveedores/wompi/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 Wompi 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 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>

  <Tab title="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>

  <Tab title="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.

    <Frame caption="Wompi disponible para instalar desde el nodo Pagos en Canvas">
      <img src="https://mintcdn.com/jelouai/qfuCOV36dV96m5-d/assets/images/integraciones/pagos/wompi-pagos-instalar.png?fit=max&auto=format&n=qfuCOV36dV96m5-d&q=85&s=95139a18f9e2d4c1c3e7c3b2f6194134" alt="Nodo Pagos en Canvas mostrando Wompi como proveedor disponible con la opción Instalar" style={{ maxHeight: '355px', width: 'auto', margin: '0 auto' }} width="500" height="708" data-path="assets/images/integraciones/pagos/wompi-pagos-instalar.png" />
    </Frame>
  </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 Wompi 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 Wompi con **credenciales de prueba** o con **credenciales de producción**.

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

    <Frame caption="Selección del ambiente para conectar Wompi">
      <img src="https://mintcdn.com/jelouai/qfuCOV36dV96m5-d/assets/images/integraciones/pagos/wompi-conectar-seleccion-ambiente.png?fit=max&auto=format&n=qfuCOV36dV96m5-d&q=85&s=d5499b48a3364c3bfc6eed82616f62dc" alt="Modal de Brain Studio para elegir entre credenciales de prueba o credenciales de producción al conectar Wompi" width="1024" height="392" data-path="assets/images/integraciones/pagos/wompi-conectar-seleccion-ambiente.png" />
    </Frame>
  </Step>

  <Step title="Completar las cuatro credenciales">
    Completa el modal con:

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

    <Frame caption="Credenciales requeridas para conectar Wompi">
      <img src="https://mintcdn.com/jelouai/qfuCOV36dV96m5-d/assets/images/integraciones/pagos/wompi-conectar-credenciales.png?fit=max&auto=format&n=qfuCOV36dV96m5-d&q=85&s=dfcec4660f4c3c5890c0b6af92d1fb00" alt="Modal de Brain Studio para ingresar llave pública, llave privada, secreto de eventos e integridad de Wompi" width="1024" height="768" data-path="assets/images/integraciones/pagos/wompi-conectar-credenciales.png" />
    </Frame>
  </Step>

  <Step title="Configurar IVA aplicado">
    Define el **IVA aplicado** que utilizará la integración durante la operación de cobro.

    <Frame caption="Configuración del IVA aplicado para Wompi">
      <img src="https://mintcdn.com/jelouai/qfuCOV36dV96m5-d/assets/images/integraciones/pagos/wompi-conectar-iva.png?fit=max&auto=format&n=qfuCOV36dV96m5-d&q=85&s=5f15bbf566ab0318e53f8602ed0977e7" alt="Modal de Brain Studio para configurar el IVA aplicado durante la conexión de Wompi" width="1024" height="429" data-path="assets/images/integraciones/pagos/wompi-conectar-iva.png" />
    </Frame>
  </Step>

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

  <Step title="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.
  </Step>
</Steps>

***

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

<Tip>
  Usa siempre credenciales del mismo ambiente. No mezcles llaves o secretos de Sandbox con llaves o secretos de Producción.
</Tip>

***

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

<Steps>
  <Step title="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.

    <Frame caption="Modal para pasar Wompi a producción">
      <img src="https://mintcdn.com/jelouai/qfuCOV36dV96m5-d/assets/images/integraciones/pagos/wompi-pasar-a-produccion.png?fit=max&auto=format&n=qfuCOV36dV96m5-d&q=85&s=081a3fb2363e6886c60fb41ff2202557" alt="Modal de Brain Studio para pasar la integración de Wompi a producción" width="1024" height="896" data-path="assets/images/integraciones/pagos/wompi-pasar-a-produccion.png" />
    </Frame>
  </Step>

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

    * **Llave pública**
    * **Llave privada**
    * **Secreto de eventos**
    * **Integridad**
  </Step>

  <Step title="Confirmar IVA aplicado">
    Revisa y confirma el **IVA aplicado** que usará la integración en producción.
  </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/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 title="Uso y configuración" href="/guides/integraciones/pagos/proveedores/wompi/uso-y-configuracion" icon="gear">
  Configura el nodo de pago y continúa el flujo según el resultado del pago en WebView.
</Card>
