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

# Obtención de credenciales

> Obtén la llave pública, la llave privada, la firma de webhook y el ID de comercio de Kushki para conectar la integración en Brain Studio.

Prepara las credenciales de **prueba** o **producción** y solicita a Kushki el webhook de Jelou.

<Check>
  Al terminar tendrás la **llave pública**, la **llave privada**, la **firma de webhook** y el **ID de comercio**, con el webhook solicitado a Kushki.
</Check>

***

## Antes de comenzar

Necesitas:

* Decidir si usarás credenciales de **prueba** o de **producción**
* Acceso de administrador a la consola Kushki del ambiente correspondiente
* Contactar a Kushki para configurar el webhook (no se crea en self-service)

***

## Ambientes en Kushki

Kushki usa una consola distinta por ambiente:

| Ambiente     | Consola                                                                 | Contacto                                                                      |
| ------------ | ----------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| Prueba (UAT) | [uat-console.kushkipagos.com](https://uat-console.kushkipagos.com/auth) | [soporte@kushkipagos.com](mailto:soporte@kushkipagos.com)                     |
| Producción   | [console.kushkipagos.com](https://console.kushkipagos.com)              | [gaelle.depenanros@kushkipagos.com](mailto:gaelle.depenanros@kushkipagos.com) |

Dónde copiar cada valor en la consola:

| Sección                            | Valor                                  |
| ---------------------------------- | -------------------------------------- |
| **Desarrolladores → Credenciales** | Llave pública y llave privada          |
| **Desarrolladores → Webhooks**     | Firma de webhook (`Webhook signature`) |
| **Mi Comercio**                    | ID de comercio                         |

<Warning>
  No mezcles credenciales entre ambientes. Si una sola credencial pertenece a otro ambiente, la instalación puede fallar o los estados de pago pueden no sincronizarse.
</Warning>

***

## URL del webhook

En prueba y producción, Kushki debe configurar esta URL:

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

<Note>
  Solicita la configuración por correo e incluye tu **ID de comercio**. En Brain Studio solo ingresas la **firma de webhook**, no la URL.
</Note>

***

## Parte 1 — Ambiente de prueba

<Steps>
  <Step title="Crear cuenta UAT">
    Regístrate en [https://uat-console.kushkipagos.com/auth/signup](https://uat-console.kushkipagos.com/auth/signup).

    Luego inicia sesión en [https://uat-console.kushkipagos.com/auth](https://uat-console.kushkipagos.com/auth).
  </Step>

  <Step title="Copiar llave pública y llave privada">
    Abre **Desarrolladores → Credenciales** y copia:

    * **Llave pública**
    * **Llave privada**

    <Frame caption="Consola Kushki UAT: Desarrolladores → Credenciales">
      <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="Pantalla de Credenciales en Kushki con llave pública y llave privada" width="2876" height="1304" data-path="assets/images/integraciones/pagos/kushki-dashboard-credenciales.png" />
    </Frame>
  </Step>

  <Step title="Copiar la firma de webhook">
    Abre **Desarrolladores → Webhooks** y copia el valor de **Webhook signature**.

    <Frame caption="Consola Kushki UAT: Desarrolladores → 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="Pantalla de Webhooks en Kushki mostrando la firma de webhook" width="2872" height="1306" data-path="assets/images/integraciones/pagos/kushki-dashboard-webhooks.png" />
    </Frame>
  </Step>

  <Step title="Copiar el ID de comercio">
    Abre **Mi Comercio** y copia el **ID de Comercio**.

    <Frame caption="Consola Kushki UAT: Mi Comercio">
      <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="Pantalla Mi Comercio en Kushki con el ID de comercio" width="2880" height="1308" data-path="assets/images/integraciones/pagos/kushki-dashboard-mi-comercio.png" />
    </Frame>
  </Step>

  <Step title="Solicitar webhook y botón de pagos">
    Escribe a [soporte@kushkipagos.com](mailto:soporte@kushkipagos.com) con tu **ID de Comercio** y solicita:

    * Configurar el webhook con `https://chat-payments.jelou.ai/kushki-webhook`
    * Activar el servicio **botón de pagos** en ese ID de comercio
  </Step>

  <Step title="Configurar Botón de pagos">
    Cuando el servicio esté activo, abre **Configuración → Integraciones → Botón de Pagos**.

    <Frame caption="Configuración → Integraciones → Botón de Pagos">
      <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="Pantalla Configuración de Kushki con la opción Botón de Pagos en Integraciones" width="2870" height="1298" data-path="assets/images/integraciones/pagos/kushki-configuracion-boton-pagos.png" />
    </Frame>

    En la pestaña **Avanzado**, activa **Información adicional de producto**.

    <Frame caption="Botón de Pagos → Avanzado: Información adicional de producto">
      <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="Pestaña Avanzado de Botón de Pagos con Información adicional de producto activada" width="968" height="1314" data-path="assets/images/integraciones/pagos/kushki-boton-pagos-avanzado.png" />
    </Frame>

    En **Datos adicionales**, configura:

    * **Etiqueta:** `Detalle de la orden`
    * **Atributo:** `orderReferenceId`

    Guarda los cambios.

    <Frame caption="Datos adicionales con atributo orderReferenceId">
      <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="Configuración de datos adicionales con etiqueta Detalle de la orden y atributo orderReferenceId" width="946" height="600" data-path="assets/images/integraciones/pagos/kushki-boton-pagos-order-reference.png" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Guarda las cuatro credenciales en un lugar seguro. Las usarás al instalar Kushki en Brain Studio.
</Tip>

***

## Parte 2 — Ambiente de producción

Jelou ya está certificado como plataforma ante Kushki. No necesitas una certificación adicional del comercio.

<Steps>
  <Step title="Solicitar accesos productivos">
    Escribe a [gaelle.depenanros@kushkipagos.com](mailto:gaelle.depenanros@kushkipagos.com) (comercial / partnerships) y solicita:

    * Accesos a la consola productiva
    * Credenciales de producción
    * Configuración del webhook con `https://chat-payments.jelou.ai/kushki-webhook`
  </Step>

  <Step title="Entrar a la consola de producción">
    Kushki enviará los accesos a [console.kushkipagos.com](https://console.kushkipagos.com). Inicia sesión con la cuenta productiva.
  </Step>

  <Step title="Copiar las credenciales productivas">
    Copia el mismo conjunto de valores:

    * **Llave pública** y **llave privada** en **Desarrolladores → Credenciales**
    * **Firma de webhook** en **Desarrolladores → Webhooks**
    * **ID de comercio** en **Mi Comercio**

    Usa este conjunto al pasar Kushki a producción en Brain Studio. No reutilices credenciales de prueba.
  </Step>

  <Step title="Configurar Botón de pagos en producción">
    Repite la configuración de **Botón de Pagos** descrita en la Parte 1:

    * Activa **Información adicional de producto**
    * En **Datos adicionales**, usa la etiqueta `Detalle de la orden` y el atributo `orderReferenceId`
    * Guarda los cambios
  </Step>
</Steps>

***

## Qué credenciales pide Brain Studio

En el paso 2 de 3 del modal de conexión, Brain Studio pide:

| Campo                | Descripción                                  |
| -------------------- | -------------------------------------------- |
| **Llave pública**    | Llave pública del ambiente que conectas      |
| **Llave privada**    | Llave privada del ambiente que conectas      |
| **ID de comercio**   | Identificador del comercio en Kushki         |
| **Firma de webhook** | Valor de **Webhook signature** en la consola |

<Frame caption="Modal Conectar Kushki: paso 2 de 3 con las cuatro credenciales">
  <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="Modal de Brain Studio paso 2 de 3 para ingresar llave pública, llave privada, ID de comercio y firma de webhook" width="1238" height="1016" data-path="assets/images/integraciones/pagos/kushki-conectar-credenciales.png" />
</Frame>

En el paso 3 defines el **IVA aplicado** y la **moneda de cobro**.

***

## Próximo paso

<Card title="Conectar en Brain Studio" href="/guides/integraciones/pagos/proveedores/kushki/conectar-en-brain-studio" icon="plug">
  Instala Kushki con las credenciales del ambiente que vas a usar y define el IVA y la moneda de cobro.
</Card>
