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

# Connect in Brain Studio

> Install Wompi in Brain Studio, configure its credentials, and use the payment node in your flows.

Connect Wompi to enable the provider in your workspace and make the payment node available in Brain Studio with an **embedded WebView** experience.

***

## Before you begin

Make sure you have:

* An **active Wompi account**
* Wompi's **public key**
* Wompi's **private key**
* Wompi's **events secret**
* Wompi's **integrity secret**
* The **VAT percentage** that the operation will apply
* The correct credentials for your environment: **Sandbox** or **Production**

<Tip>
  To obtain or review credentials, follow [Obtaining credentials](/guides/integraciones/pagos/proveedores/wompi/obtener-credenciales).
</Tip>

<Warning>
  For the checkout to open inside WhatsApp as an embedded WebView, the account must be **WhatsApp Business verified**.

  If it is not verified, the checkout will open in the device's external browser.
</Warning>

***

## Ways to start the installation

You can start the Wompi installation from different points in Brain Studio. All paths use the same provider configuration.

<Tabs>
  <Tab title="Jelou Agent">
    Ask Jelou Agent to add payments with Wompi while you build or adjust a flow.

    Examples:

    * "Add payments with Wompi to this flow"
    * "I need to charge with Wompi for this case"
    * "I want to process payments with Wompi"

    Jelou Agent detects Wompi as an available provider from Marketplace and triggers the assisted installation flow.
  </Tab>

  <Tab title="Marketplace">
    Open **Marketplace**, search for **Wompi** in **Payments & Processing** or use the search bar.

    Then press **Connect** or **Install** to start the installation flow.
  </Tab>

  <Tab title="Payments Node">
    From the **Canvas** toolbar, open the **Payments** node.

    Inside the **Payments** node, you can see **Wompi** as an available provider. If it is not connected yet, press **Install** to start the same connection flow used by Marketplace, Jelou Agent, and templates.

    <Frame caption="Wompi available to install from the Payments node in 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="Payments node in Canvas showing Wompi as an available provider with the Install option" 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">
    Some Brain Studio templates may include a payment configuration.

    While creating the template, Brain Studio may ask you to choose a payment provider and connect Wompi as part of the configuration flow.
  </Tab>
</Tabs>

<Note>
  All installation paths use the same provider configuration. What changes is where you start the flow.
</Note>

***

## Common installation flow

Regardless of the entry point, the shared process is the following.

<Note>
  The first modal asks you to choose **Try with Jelou** or **Connect my account**.

  * **Try with Jelou:** installs the gateway in [test mode](/guides/integraciones/pagos/modo-prueba), without an account or your own credentials.
  * **Connect my account:** uses your test or production credentials. Continue with the steps on this page.
</Note>

<Steps>
  <Step title="Choose test or production credentials">
    Brain Studio will ask you to select whether you will connect Wompi with **test credentials** or **production credentials**.

    In Wompi, these credentials correspond to **Sandbox** or **Production** keys.

    <Frame caption="Environment selection to connect 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="Brain Studio modal to choose between test credentials or production credentials when connecting Wompi" width="1024" height="392" data-path="assets/images/integraciones/pagos/wompi-conectar-seleccion-ambiente.png" />
    </Frame>
  </Step>

  <Step title="Complete the four credentials">
    Complete the modal with:

    * **Public key**
    * **Private key**
    * **Events secret**
    * **Integrity**

    <Frame caption="Credentials required to connect 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="Brain Studio modal to enter Wompi's public key, private key, events secret, and integrity" width="1024" height="768" data-path="assets/images/integraciones/pagos/wompi-conectar-credenciales.png" />
    </Frame>
  </Step>

  <Step title="Configure applied VAT">
    Define the **applied VAT** that the integration will use during the payment operation.

    <Frame caption="Applied VAT configuration for 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="Brain Studio modal to configure the applied VAT during the Wompi connection" width="1024" height="429" data-path="assets/images/integraciones/pagos/wompi-conectar-iva.png" />
    </Frame>
  </Step>

  <Step title="Confirm connection">
    Confirm the connection. Brain Studio will save the configuration and make **Wompi** available in your workspace.
  </Step>

  <Step title="Use Wompi from the Payments node in Canvas">
    After installing, you can use Wompi from the **Payments** node in **Canvas**, whether the flow started from Jelou Agent, Marketplace, the Payments node, or a template.
  </Step>
</Steps>

***

## Sandbox vs Production credentials

Wompi separates credentials by environment:

* **Sandbox:** credentials for testing without real money.
* **Production:** credentials for processing real payments.

Keys and secrets have different prefixes depending on the environment:

| Environment | Public key     | Private key    | Events secret     | Integrity secret     |
| ----------- | -------------- | -------------- | ----------------- | -------------------- |
| Sandbox     | `pub_test_...` | `prv_test_...` | `test_events_...` | `test_integrity_...` |
| Production  | `pub_prod_...` | `prv_prod_...` | `prod_events_...` | `prod_integrity_...` |

<Warning>
  Sandbox credentials do not process real payments. Before going live, you must connect Wompi using production credentials.
</Warning>

<Tip>
  Always use credentials from the same environment. Do not mix Sandbox keys or secrets with Production keys or secrets.
</Tip>

***

## Switch to production

If you installed Wompi with **development/Sandbox** credentials, you can use the payment node for testing. To operate with real payments:

<Steps>
  <Step title="Open Switch to production">
    You can start the change from:

    * The **advanced sidebar** of the Wompi node in **Canvas**
    * The **Wompi** page in **Marketplace**

    In both cases, the same modal opens to switch the integration to production.

    <Frame caption="Modal to switch Wompi to production">
      <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="Brain Studio modal to switch the Wompi integration to production" width="1024" height="896" data-path="assets/images/integraciones/pagos/wompi-pasar-a-produccion.png" />
    </Frame>
  </Step>

  <Step title="Complete production credentials">
    Enter the Production credentials:

    * **Public key**
    * **Private key**
    * **Events secret**
    * **Integrity**
  </Step>

  <Step title="Confirm applied VAT">
    Review and confirm the **applied VAT** that the integration will use in production.
  </Step>

  <Step title="Confirm the change">
    Confirm the action. From that moment on, the integration operates with production credentials.
  </Step>
</Steps>

***

## Change credentials

* To switch from **development/Sandbox** to **Production** with the same installation, use the **Switch to production** section.
* To **rotate credentials** or **replace the configuration**, disconnect Wompi and reinstall it following the **common installation flow** on this page.

***

## Next step

Once the integration is connected, continue with:

<Card title="Usage and configuration" href="/guides/integraciones/pagos/proveedores/wompi/uso-y-configuracion" icon="gear">
  Configure the payment node and continue the flow based on the WebView payment result.
</Card>
