> ## 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 Kushki in Brain Studio, configure its credentials, and use the payment node in your flows.

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

***

## Before you begin

Make sure you have:

* An **active Kushki account**
* Kushki **public key**
* Kushki **private key**
* Kushki **merchant ID**
* Kushki **webhook signature**
* **VAT percentage** for the operation
* **Collection currency** matching your account country
* **Webhook** requested from Kushki with URL `https://chat-payments.jelou.ai/kushki-webhook`
* Correct credentials for the environment: **test** or **production**

> [!TIP]
>
> To obtain or review credentials and request the webhook from Kushki, follow [Getting credentials](https://docs.jelou.ai/en/guides/integrations/payments/providers/kushki/get-credentials.md).

> [!WARNING]
>
> For checkout to open inside WhatsApp as an embedded WebView, the account must be **WhatsApp Business verified**.
>
> If it is not verified, checkout will open in the device's external browser.

***

## Ways to start installation

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

> [tab] Jelou Agent
>
> Ask Jelou Agent to add Kushki payments while building or adjusting a flow.
>
> Examples:
>
> * "Add Kushki payments to this flow"
> * "I need to charge with Kushki in this case"
> * "I want to process payments with Kushki"
>
> Jelou Agent detects Kushki as an available provider from Marketplace and starts the assisted installation flow.

> [tab] Marketplace
>
> Open **Marketplace**, search for **Kushki** under **Payments & Processing**, or use the search bar.
>
> Then press **Connect** or **Install** to start the installation flow.

> [tab] Payments node
>
> From the **Canvas** toolbar, open the **Payments** node.
>
> Inside the **Payments** node you can see **Kushki** as an available provider. If not yet connected, press **Install** to start the same connection flow used by Marketplace, Jelou Agent, and templates.

> [tab] Templates
>
> Some Brain Studio templates may include payment configuration.
>
> During template creation, Brain Studio may ask you to choose a payment provider and connect Kushki as part of the setup flow.

> [!NOTE]
>
> All installation routes use the same provider configuration. What changes is where you start the flow.

***

## Common installation flow

Regardless of entry point, the shared process is as follows.

> [!NOTE]
>
> The first modal asks you to choose **Try with Jelou** or **Connect my account**.
>
> * **Try with Jelou:** installs the gateway in [test mode](https://docs.jelou.ai/guides/integraciones/pagos/modo-prueba.md), without an account or your own credentials.
> * **Connect my account:** uses your test or production credentials. Continue with the steps on this page.

**1. Choose test or production credentials**

Select the connection environment:

* **Test credentials**
* **Production credentials**

![Brain Studio modal step 1 of 3 to choose test or production credentials when connecting 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)

Step 1 of 3: environment selection to connect Kushki

**2. Complete Kushki credentials**

Complete the modal (step 2 of 3) with:

* **Public key**
* **Private key**
* **Merchant ID**
* **Webhook signature**

![Brain Studio modal step 2 of 3 to enter Kushki public key, private key, merchant ID, and webhook signature](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-conectar-credenciales.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=86c08ac5d6e7786985efbb1c68ca4891)

Step 2 of 3: credentials required to connect Kushki

**3. Configure VAT and collection currency**

Define **applied VAT** and select **collection currency**.

Available currencies are:

| Currency | Typical country |
| - | - |
| `USD` — US dollar | Ecuador |
| `COP` — Colombian peso | Colombia |
| `CLP` — Chilean peso | Chile |
| `MXN` — Mexican peso | Mexico |
| `PEN` — Peruvian sol | Peru |

![Brain Studio modal step 3 of 3 to configure applied VAT and collection currency when connecting Kushki](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-conectar-iva.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=755e2bdaccf7ebad853b4c8fc0cec100)

Step 3 of 3: applied VAT and collection currency

**4. Confirm connection**

Press **Continue** / **Connect integration**. Brain Studio will save the configuration and make **Kushki** available in your workspace.

**5. Use Kushki from Payments node in Canvas**

After installation, you can use Kushki from the **Payments** node in **Canvas**, whether the flow started from Jelou Agent, Marketplace, Payments node, or a template.

***

## Test vs production credentials

Kushki separates credentials by environment:

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

> [!WARNING]
>
> Test credentials do not process real payments. Before operating in production, connect Kushki with production credentials or use **Go live**.

> [!TIP]
>
> Always use credentials from the same environment. Do not mix test keys with production keys.

***

## Go live

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

**1. Open Go live**

You can start the change from either of these points:

> [tab] Advanced panel in Canvas
>
> Open the **Kushki** node in **Canvas**, go to the **Advanced** tab, and select **Production**.
>
> ![Advanced sidebar of the Kushki node in Canvas with option to move the integration to production](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)
>
> Go live from the Advanced tab of the Kushki node

> [tab] Marketplace
>
> Open the **Kushki** page in **Marketplace** and press **Go live**.

In both cases the same modal opens to move the integration to production.

**2. Complete production credentials**

Enter the same credentials as during installation, but from the production environment:

* **Public key**
* **Private key**
* **Merchant ID**
* **Webhook signature**

> [!WARNING]
>
> In production, each transaction has a cost of **\$0.10 USD** per payment, deducted from your Brain Studio balance, in addition to Kushki fees.

**3. Confirm the change**

Confirm the action. From that point on, the integration operates with production credentials.

***

## Change credentials

* To move from **development/test** to **production** with the same installation, use the **Go live** section.
* To **rotate credentials** or **replace configuration**, disconnect Kushki and reinstall following the **common installation flow** on this page.

***

## Next step

Once the integration is connected, continue with:

> [card] [Usage and configuration](https://docs.jelou.ai/en/guides/integrations/payments/providers/kushki/usage-and-settings.md)
>
> Configure the payment node and continue the flow based on the WebView payment result.


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