> ## 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](/en/guides/integraciones/pagos/proveedores/kushki/obtener-credenciales).
</Tip>

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

***

## Ways to start installation

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

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

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

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

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

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

***

## Common installation flow

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

<Steps>
  <Step title="Choose test or production credentials">
    Select the connection environment:

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

    <Frame caption="Step 1 of 3: environment selection to connect Kushki">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-conectar-seleccion-ambiente.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=918b7b1a0e3bb9ea542d19131bcc9d9f" alt="Brain Studio modal step 1 of 3 to choose test or production credentials when connecting Kushki" width="1246" height="566" data-path="assets/images/integraciones/pagos/kushki-conectar-seleccion-ambiente.png" />
    </Frame>
  </Step>

  <Step title="Complete Kushki credentials">
    Complete the modal (step 2 of 3) with:

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

    <Frame caption="Step 2 of 3: credentials required to connect Kushki">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-conectar-credenciales.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=70f1a1a8571cc60ea81b75dee4b538df" alt="Brain Studio modal step 2 of 3 to enter Kushki public key, private key, merchant ID, and webhook signature" width="1238" height="1016" data-path="assets/images/integraciones/pagos/kushki-conectar-credenciales.png" />
    </Frame>
  </Step>

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

    <Frame caption="Step 3 of 3: applied VAT and collection currency">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-conectar-iva.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=bec95934e6b29879deccbf925a633a8e" alt="Brain Studio modal step 3 of 3 to configure applied VAT and collection currency when connecting Kushki" width="1232" height="842" data-path="assets/images/integraciones/pagos/kushki-conectar-iva.png" />
    </Frame>
  </Step>

  <Step title="Confirm connection">
    Press **Continue** / **Connect integration**. Brain Studio will save the configuration and make **Kushki** available in your workspace.
  </Step>

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

***

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

<Tip>
  Always use credentials from the same environment. Do not mix test keys with production keys.
</Tip>

***

## Go live

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

<Steps>
  <Step title="Open Go live">
    You can start the change from either of these points:

    <Tabs>
      <Tab title="Advanced panel in Canvas">
        Open the **Kushki** node in **Canvas**, go to the **Advanced** tab, and select **Production**.

        <Frame caption="Go live from the Advanced tab of the Kushki node">
          <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-pasar-a-produccion-avanzado.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=384162aa6b962dda00334667f8d39b41" alt="Advanced sidebar of the Kushki node in Canvas with option to move the integration to production" width="1162" height="656" data-path="assets/images/integraciones/pagos/kushki-pasar-a-produccion-avanzado.png" />
        </Frame>
      </Tab>

      <Tab title="Marketplace">
        Open the **Kushki** page in **Marketplace** and press **Go live**.
      </Tab>
    </Tabs>

    In both cases the same modal opens to move the integration to production.
  </Step>

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

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

***

## 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 title="Usage and configuration" href="/en/guides/integraciones/pagos/proveedores/kushki/uso-y-configuracion" icon="gear">
  Configure the payment node and continue the flow based on the WebView payment result.
</Card>
