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

# Getting credentials

> Get Kushki's public key, private key, webhook signature, and merchant ID to connect the integration in Brain Studio.

Prepare **test** or **production** credentials and ask Kushki to configure the Jelou webhook.

<Check>
  When you finish, you will have the **public key**, **private key**, **webhook signature**, and **merchant ID**, with the webhook requested from Kushki.
</Check>

***

## Before you begin

You need:

* To decide whether you will use **test** or **production** credentials
* Administrator access to the Kushki console for that environment
* To contact Kushki to configure the webhook (it is not created in self-service)

***

## Environments in Kushki

Kushki uses a different console per environment:

| Environment | Console                                                                 | Contact                                                                       |
| ----------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| Test (UAT)  | [uat-console.kushkipagos.com](https://uat-console.kushkipagos.com/auth) | [soporte@kushkipagos.com](mailto:soporte@kushkipagos.com)                     |
| Production  | [console.kushkipagos.com](https://console.kushkipagos.com)              | [gaelle.depenanros@kushkipagos.com](mailto:gaelle.depenanros@kushkipagos.com) |

Where to copy each value in the console:

| Section                      | Value                      |
| ---------------------------- | -------------------------- |
| **Developers → Credentials** | Public key and private key |
| **Developers → Webhooks**    | Webhook signature          |
| **My Merchant**              | Merchant ID                |

<Warning>
  Do not mix credentials across environments. If even one credential belongs to the wrong environment, installation may fail or payment statuses may not sync.
</Warning>

***

## Webhook URL

In test and production, Kushki must configure this URL:

```text theme={null}
https://chat-payments.jelou.ai/kushki-webhook
```

<Note>
  Request the configuration by email and include your **merchant ID**. In Brain Studio you only enter the **webhook signature**, not the URL.
</Note>

***

## Part 1 — Test environment

<Steps>
  <Step title="Create a UAT account">
    Sign up at [https://uat-console.kushkipagos.com/auth/signup](https://uat-console.kushkipagos.com/auth/signup).

    Then sign in at [https://uat-console.kushkipagos.com/auth](https://uat-console.kushkipagos.com/auth).
  </Step>

  <Step title="Copy public key and private key">
    Open **Developers → Credentials** and copy:

    * **Public key**
    * **Private key**

    <Frame caption="Kushki UAT console: Developers → Credentials">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-dashboard-credenciales.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=2954e5ff410de531b99be4cdc2627d69" alt="Kushki Credentials screen with public key and private key" width="2876" height="1304" data-path="assets/images/integraciones/pagos/kushki-dashboard-credenciales.png" />
    </Frame>
  </Step>

  <Step title="Copy the webhook signature">
    Open **Developers → Webhooks** and copy the **Webhook signature** value.

    <Frame caption="Kushki UAT console: Developers → Webhooks">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-dashboard-webhooks.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=e69c3c06720205b39ebcac694b16347c" alt="Kushki Webhooks screen showing the webhook signature" width="2872" height="1306" data-path="assets/images/integraciones/pagos/kushki-dashboard-webhooks.png" />
    </Frame>
  </Step>

  <Step title="Copy the merchant ID">
    Open **My Merchant** and copy the **Merchant ID**.

    <Frame caption="Kushki UAT console: My Merchant">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-dashboard-mi-comercio.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=51dacf3e0e8c9176bb4537bf2ff47a71" alt="Kushki My Merchant screen with the merchant ID" width="2880" height="1308" data-path="assets/images/integraciones/pagos/kushki-dashboard-mi-comercio.png" />
    </Frame>
  </Step>

  <Step title="Request webhook and payment button">
    Email [soporte@kushkipagos.com](mailto:soporte@kushkipagos.com) with your **merchant ID** and request:

    * Configure the webhook with `https://chat-payments.jelou.ai/kushki-webhook`
    * Enable the **payment button** service on that merchant ID
  </Step>

  <Step title="Configure Payment button">
    When the service is active, open **Settings → Integrations → Payment Button**.

    <Frame caption="Settings → Integrations → Payment Button">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-configuracion-boton-pagos.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=35fe1cde2e45f02444413de35543a0d2" alt="Kushki Settings screen with Payment Button option under Integrations" width="2870" height="1298" data-path="assets/images/integraciones/pagos/kushki-configuracion-boton-pagos.png" />
    </Frame>

    In the **Advanced** tab, enable **Additional product information**.

    <Frame caption="Payment Button → Advanced: Additional product information">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-boton-pagos-avanzado.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=3d1b877844d424504d3c4b706a7325e1" alt="Payment Button Advanced tab with Additional product information enabled" width="968" height="1314" data-path="assets/images/integraciones/pagos/kushki-boton-pagos-avanzado.png" />
    </Frame>

    Under **Additional data**, configure:

    * **Label:** `Detalle de la orden`
    * **Attribute:** `orderReferenceId`

    Save the changes.

    <Frame caption="Additional data with orderReferenceId attribute">
      <img src="https://mintcdn.com/jelouai/BJIoathnR7ANCT6N/assets/images/integraciones/pagos/kushki-boton-pagos-order-reference.png?fit=max&auto=format&n=BJIoathnR7ANCT6N&q=85&s=a17f5b5ab0dfd8cd0d8b11f6256cc1ae" alt="Additional data configuration with Detalle de la orden label and orderReferenceId attribute" width="946" height="600" data-path="assets/images/integraciones/pagos/kushki-boton-pagos-order-reference.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Store the four credentials securely. You will use them when installing Kushki in Brain Studio.
</Tip>

***

## Part 2 — Production environment

Jelou is already certified as a platform with Kushki. You do not need additional merchant certification.

<Steps>
  <Step title="Request production access">
    Email [gaelle.depenanros@kushkipagos.com](mailto:gaelle.depenanros@kushkipagos.com) (commercial / partnerships) and request:

    * Access to the production console
    * Production credentials
    * Webhook configuration with `https://chat-payments.jelou.ai/kushki-webhook`
  </Step>

  <Step title="Sign in to the production console">
    Kushki will send access to [console.kushkipagos.com](https://console.kushkipagos.com). Sign in with the production account.
  </Step>

  <Step title="Copy production credentials">
    Copy the same set of values:

    * **Public key** and **private key** under **Developers → Credentials**
    * **Webhook signature** under **Developers → Webhooks**
    * **Merchant ID** under **My Merchant**

    Use this set when moving Kushki to production in Brain Studio. Do not reuse test credentials.
  </Step>

  <Step title="Configure Payment button in production">
    Repeat the **Payment Button** configuration from Part 1:

    * Enable **Additional product information**
    * Under **Additional data**, use label `Detalle de la orden` and attribute `orderReferenceId`
    * Save the changes
  </Step>
</Steps>

***

## What Brain Studio requests

In step 2 of 3 of the connection modal, Brain Studio asks for:

| Field                 | Description                                        |
| --------------------- | -------------------------------------------------- |
| **Public key**        | Public key for the environment you are connecting  |
| **Private key**       | Private key for the environment you are connecting |
| **Merchant ID**       | Merchant identifier in Kushki                      |
| **Webhook signature** | **Webhook signature** value from the console       |

<Frame caption="Connect Kushki modal: step 2 of 3 with the four credentials">
  <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 public key, private key, merchant ID, and webhook signature" width="1238" height="1016" data-path="assets/images/integraciones/pagos/kushki-conectar-credenciales.png" />
</Frame>

In step 3 you define **applied VAT** and **collection currency**.

***

## Next step

<Card title="Connect in Brain Studio" href="/en/guides/integraciones/pagos/proveedores/kushki/conectar-en-brain-studio" icon="plug">
  Install Kushki with credentials for the environment you will use and define VAT and collection currency.
</Card>
