> ## 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 y configura el webhook de Conekta desde el panel de administración para conectar Conekta en Brain Studio.

Esta guía te acompaña en la preparación de credenciales y webhooks para pruebas y producción en el [panel de Conekta](https://panel.conekta.com/).

> [!TIP]
>
> Al finalizar esta guía tendrás la **llave pública**, la **llave privada** y el **webhook** configurados para conectar Conekta en Brain Studio.

***

## Antes de comenzar

Necesitas:

* Una **cuenta activa de Conekta**
* Acceso al **[panel de Conekta](https://panel.conekta.com/)** con permisos de administrador
* Definir si conectarás credenciales de **prueba** o de **producción**

***

## Ambientes en Conekta

Conekta separa las credenciales por ambiente:

* **Prueba:** ambiente de pruebas. Permite simular pagos sin mover dinero real.
* **Producción:** ambiente real. Procesa transacciones con dinero real.

Cada ambiente tiene su propio par de llaves y su propio webhook. No mezcles credenciales ni webhooks de prueba con los de producción.

| Ambiente | Llave pública | Llave privada | Webhook |
| - | - | - | - |
| Prueba | Visible en **API Keys de prueba** | Debes crearla con **Crear nueva llave privada** | Configúralo con **Modo Pruebas** activo |
| Producción | Visible en **API Keys de producción** | Debes crearla con **Crear nueva llave privada** | Configúralo con **Modo Pruebas** desactivado |

> [!WARNING]
>
> No mezcles credenciales ni webhooks entre ambientes. Si una sola llave o webhook pertenece a otro ambiente, la instalación puede fallar o los estados de pago pueden no sincronizarse correctamente.

> [!NOTE]
>
> Conekta solo permite **copiar o ver la llave privada en el momento de su creación**. Si la pierdes, deberás generar una nueva.

***

## URL y eventos del webhook

En ambos ambientes debes usar la misma URL de notificación:

```text theme={null}
https://chat-payments.jelou.ai/link-webhook?provider=CONEKTA
```

Selecciona estos **5 eventos** dentro de la categoría **orders**:

| Evento | Descripción |
| - | - |
| `order.expired` | La orden expiró |
| `order.paid` | La orden fue pagada |
| `order.pending_payment` | La orden quedó pendiente de pago |
| `order.refunded` | La orden fue reembolsada |
| `order.declined` | La orden fue rechazada |

> [!NOTE]
>
> Brain Studio usa estos eventos para actualizar el estado del pago y continuar el flujo por la salida correspondiente.

***

## Parte 1 — Preparar credenciales y webhook de prueba

**1. Entrar al panel de Conekta**

Inicia sesión en [https://panel.conekta.com/](https://panel.conekta.com/) con la cuenta del comercio.

**2. Activar modo prueba**

En la esquina **inferior izquierda** del panel, activa el interruptor **Modo Pruebas**.

Deberías ver el aviso **El modo de pruebas está habilitado** en la parte superior del panel.

**3. Abrir Desarrolladores**

En el menú lateral, abre **Desarrollador**.

![Panel de Conekta con modo prueba activo, sección Desarrolladores visible y tarjeta Webhooks al final](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/conekta-dashboard-desarrolladores-prueba.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=1d499b5c04e79418eb212c4430d7ae83)

Panel de Conekta con modo prueba activo, sección Desarrolladores y tarjeta Webhooks

**4. Consultar API Keys de prueba**

En la tarjeta **Ver API Keys**, haz clic en **Consultar API Keys de prueba**.

**5. Copiar la llave pública**

En la sección **Llave pública**, copia la llave activa con **Copiar llave**.

![Pantalla de API Keys de prueba de Conekta mostrando la llave pública y el botón Crear nueva llave privada](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/conekta-dashboard-api-keys-prueba.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=5d540f853ca2e4fa60c2996d5d1d9c82)

API Keys de prueba: llave pública y creación de llave privada

**6. Crear y copiar la llave privada**

En la sección **Llaves privadas**, haz clic en **Crear nueva llave privada**.

Asigna un nombre descriptivo, confirma la creación y **copia la llave privada de inmediato**. Conekta no volverá a mostrarla completa después de cerrar ese paso.

**7. Abrir Webhooks de prueba**

Regresa a **Desarrollador**. En la tarjeta **Webhooks**, haz clic en **Revisar webhooks**.

**8. Crear el webhook de prueba**

Haz clic en **Crear Webhook** y completa:

* **URL del webhook:** `https://chat-payments.jelou.ai/link-webhook?provider=CONEKTA`
* **Nombre o descripción:** un nombre descriptivo, por ejemplo `Jelou Brain`
* **Eventos a notificar:** selecciona los 5 eventos de **orders** indicados arriba

![Modal de Conekta para crear webhook con URL, nombre y selector de eventos](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/conekta-webhook-crear-modal.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=a58e8637030f2f114da4c620e597ffc1)

Modal Crear Webhook en Conekta

![Selector de eventos del webhook de Conekta con order.expired, order.paid, order.pending\_payment, order.refunded y order.declined seleccionados](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/conekta-webhook-eventos-orders.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=2f0fbbdac68c739ec44b3440913294c5)

Eventos de orders a seleccionar en el webhook

**9. Confirmar webhook de prueba activo**

Guarda el webhook y verifica que quede **Activo** con la URL de Jelou.

![Lista de webhooks de prueba de Conekta mostrando un webhook activo con la URL de Jelou](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/conekta-webhooks-lista-prueba.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=d9812babd84f68d4c4e22aa56166b2dc)

Webhook de prueba activo en Conekta

***

## Parte 2 — Preparar credenciales y webhook de producción

**1. Desactivar modo prueba**

En la esquina **inferior izquierda** del panel, desactiva el interruptor **Modo Pruebas**.

Confirma que ya no aparece el aviso de modo de pruebas habilitado.

**2. Abrir Desarrolladores**

En el menú lateral, abre **Desarrollador**.

![Panel de Conekta con modo prueba desactivado y la sección Desarrolladores visible](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/conekta-dashboard-desarrolladores-produccion.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=ad4905c14087758243fd22f777dda87d)

Panel de Conekta con modo prueba desactivado y sección Desarrolladores

**3. Consultar API Keys de producción**

En la tarjeta **Ver API Keys**, haz clic en **Consultar API Keys de producción**.

**4. Copiar la llave pública**

En la sección **Llave pública**, copia la llave activa con **Copiar llave**.

![Pantalla de API Keys de producción de Conekta mostrando la llave pública y el botón Crear nueva llave privada](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/conekta-dashboard-api-keys-produccion.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=602e9001954c6243b35cc31e70a84d48)

API Keys de producción: llave pública y creación de llave privada

**5. Crear y copiar la llave privada**

En la sección **Llaves privadas**, haz clic en **Crear nueva llave privada**.

Asigna un nombre descriptivo, confirma la creación y **copia la llave privada de inmediato**.

Cuando pases Conekta a producción en Brain Studio, usa este par productivo. No reutilices credenciales de prueba.

**6. Abrir Webhooks de producción**

Regresa a **Desarrollador**. En la tarjeta **Webhooks**, haz clic en **Revisar webhooks**.

**7. Crear el webhook de producción**

Haz clic en **Crear Webhook** y completa la misma configuración que en prueba:

* **URL del webhook:** `https://chat-payments.jelou.ai/link-webhook?provider=CONEKTA`
* **Nombre o descripción:** un nombre descriptivo, por ejemplo `Jelou Brain`
* **Eventos a notificar:** selecciona los 5 eventos de **orders** indicados arriba

Confirma que el webhook quede **Activo** en el ambiente de producción.

***

## Qué credenciales pide Brain Studio

Al instalar Conekta, Brain Studio solicita:

| Campo | Descripción |
| - | - |
| **Llave pública** | Llave pública activa del ambiente que estés conectando |
| **Llave privada** | Llave privada que acabas de crear en Conekta |
| **IVA aplicado** | Porcentaje de IVA que usará la integración durante el cobro |

> [!NOTE]
>
> El IVA se configura durante la conexión en Brain Studio, no en el panel de Conekta. El webhook se configura directamente en Conekta y no se ingresa en Brain Studio.

***

## Próximo paso

> [card] [Conectar en Brain Studio](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/conekta/conectar-en-brain-studio.md)
>
> Instala Conekta usando las credenciales del ambiente que vas a usar y define el IVA aplicado para la integración.


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