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

> [!TIP]
>
> 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.

***

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

***

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

***

## Parte 1 — Ambiente de prueba

**1. 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).

**2. Copiar llave pública y llave privada**

Abre **Desarrolladores → Credenciales** y copia:

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

![Pantalla de Credenciales en Kushki con llave pública y llave privada](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-dashboard-credenciales.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=3aae8b21959c2ca86c4db0409f4c7973)

Consola Kushki UAT: Desarrolladores → Credenciales

**3. Copiar la firma de webhook**

Abre **Desarrolladores → Webhooks** y copia el valor de **Webhook signature**.

![Pantalla de Webhooks en Kushki mostrando la firma de webhook](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-dashboard-webhooks.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=bf82e3e69ab35d005771604c72ffdb78)

Consola Kushki UAT: Desarrolladores → Webhooks

**4. Copiar el ID de comercio**

Abre **Mi Comercio** y copia el **ID de Comercio**.

![Pantalla Mi Comercio en Kushki con el ID de comercio](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-dashboard-mi-comercio.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=cec6301c966e8925a01e4a1b647c0757)

Consola Kushki UAT: Mi Comercio

**5. 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

**6. Configurar Botón de pagos**

Cuando el servicio esté activo, abre **Configuración → Integraciones → Botón de Pagos**.

![Pantalla Configuración de Kushki con la opción Botón de Pagos en Integraciones](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-configuracion-boton-pagos.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=5c6f0c7c590672058cd1fc3e5dabbdbb)

Configuración → Integraciones → Botón de Pagos

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

![Pestaña Avanzado de Botón de Pagos con Información adicional de producto activada](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-boton-pagos-avanzado.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=f48d9c20ad5fb53956ad8a6d42b0c933)

Botón de Pagos → Avanzado: Información adicional de producto

En **Datos adicionales**, configura:

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

Guarda los cambios.

![Configuración de datos adicionales con etiqueta Detalle de la orden y atributo orderReferenceId](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-boton-pagos-order-reference.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=cd527388398682aeb49b838faa0de82d)

Datos adicionales con atributo orderReferenceId

> [!TIP]
>
> Guarda las cuatro credenciales en un lugar seguro. Las usarás al instalar Kushki en Brain Studio.

***

## Parte 2 — Ambiente de producción

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

**1. 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`

**2. 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.

**3. 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.

**4. 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

***

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

![Modal de Brain Studio paso 2 de 3 para ingresar llave pública, llave privada, ID de comercio y firma de webhook](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/kushki-conectar-credenciales.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=86c08ac5d6e7786985efbb1c68ca4891)

Modal Conectar Kushki: paso 2 de 3 con las cuatro credenciales

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

***

## Próximo paso

> [card] [Conectar en Brain Studio](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/kushki/conectar-en-brain-studio.md)
>
> Instala Kushki con las credenciales del ambiente que vas a usar y define el IVA y la moneda de cobro.


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