> ## 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 Conekta's public key, private key, and configure the webhook from the admin panel to connect Conekta in Brain Studio.

This guide walks you through preparing credentials and webhooks for test and production in the [Conekta panel](https://panel.conekta.com/).

> [!TIP]
>
> When you finish this guide, you will have the **public key**, **private key**, and **webhook** configured to connect Conekta in Brain Studio.

***

## Before you begin

You need:

* An **active Conekta account**
* Access to the **[Conekta panel](https://panel.conekta.com/)** with administrator permissions
* A decision on whether you will connect **test** or **production** credentials

***

## Environments in Conekta

Conekta separates credentials by environment:

* **Test:** test environment. Lets you simulate payments without moving real money.
* **Production:** live environment. Processes transactions with real money.

Each environment has its own key pair and its own webhook. Do not mix test credentials or webhooks with production ones.

| Environment | Public key | Private key | Webhook |
| - | - | - | - |
| Test | Visible in **Test API Keys** | You must create it with **Create new private key** | Configure it with **Test Mode** enabled |
| Production | Visible in **Production API Keys** | You must create it with **Create new private key** | Configure it with **Test Mode** disabled |

> [!WARNING]
>
> Do not mix credentials or webhooks across environments. If even one key or webhook belongs to the wrong environment, installation may fail or payment statuses may not sync correctly.

> [!NOTE]
>
> Conekta only lets you **copy or view the private key at the moment it is created**. If you lose it, you must generate a new one.

***

## Webhook URL and events

In both environments you must use the same notification URL:

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

Select these **5 events** within the **orders** category:

| Event | Description |
| - | - |
| `order.expired` | The order expired |
| `order.paid` | The order was paid |
| `order.pending_payment` | The order is pending payment |
| `order.refunded` | The order was refunded |
| `order.declined` | The order was declined |

> [!NOTE]
>
> Brain Studio uses these events to update the payment status and continue the flow through the corresponding output.

***

## Part 1 — Prepare test credentials and webhook

**1. Sign in to the Conekta panel**

Log in at [https://panel.conekta.com/](https://panel.conekta.com/) with the merchant account.

**2. Enable test mode**

In the **bottom-left corner** of the panel, turn on the **Test Mode** switch.

You should see the **Test mode is enabled** notice at the top of the panel.

**3. Open Developers**

In the sidebar menu, open **Developer**.

![Conekta panel with test mode enabled, Developers section visible, and Webhooks card at the bottom](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/conekta-dashboard-desarrolladores-prueba.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=1d499b5c04e79418eb212c4430d7ae83)

Conekta panel with test mode enabled, Developers section, and Webhooks card

**4. View test API Keys**

In the **View API Keys** card, click **View test API Keys**.

**5. Copy the public key**

In the **Public key** section, copy the active key using **Copy key**.

![Conekta test API Keys screen showing the public key and the Create new private key button](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)

Test API Keys: public key and private key creation

**6. Create and copy the private key**

In the **Private keys** section, click **Create new private key**.

Assign a descriptive name, confirm creation, and **copy the private key immediately**. Conekta will not show the full key again after you close that step.

**7. Open test Webhooks**

Return to **Developer**. In the **Webhooks** card, click **Review webhooks**.

**8. Create the test webhook**

Click **Create Webhook** and complete:

* **Webhook URL:** `https://chat-payments.jelou.ai/link-webhook?provider=CONEKTA`
* **Name or description:** a descriptive name, for example `Jelou Brain`
* **Events to notify:** select the 5 **orders** events listed above

![Conekta modal to create webhook with URL, name, and event selector](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/conekta-webhook-crear-modal.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=a58e8637030f2f114da4c620e597ffc1)

Create Webhook modal in Conekta

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

Orders events to select in the webhook

**9. Confirm active test webhook**

Save the webhook and verify it is **Active** with the Jelou URL.

![Conekta test webhooks list showing an active webhook with the Jelou URL](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/conekta-webhooks-lista-prueba.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=d9812babd84f68d4c4e22aa56166b2dc)

Active test webhook in Conekta

***

## Part 2 — Prepare production credentials and webhook

**1. Disable test mode**

In the **bottom-left corner** of the panel, turn off the **Test Mode** switch.

Confirm that the test mode notice no longer appears.

**2. Open Developers**

In the sidebar menu, open **Developer**.

![Conekta panel with test mode disabled and the Developers section 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)

Conekta panel with test mode disabled and Developers section

**3. View production API Keys**

In the **View API Keys** card, click **View production API Keys**.

**4. Copy the public key**

In the **Public key** section, copy the active key using **Copy key**.

![Conekta production API Keys screen showing the public key and the Create new private key button](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)

Production API Keys: public key and private key creation

**5. Create and copy the private key**

In the **Private keys** section, click **Create new private key**.

Assign a descriptive name, confirm creation, and **copy the private key immediately**.

When you move Conekta to production in Brain Studio, use this production pair. Do not reuse test credentials.

**6. Open production Webhooks**

Return to **Developer**. In the **Webhooks** card, click **Review webhooks**.

**7. Create the production webhook**

Click **Create Webhook** and complete the same configuration as in test:

* **Webhook URL:** `https://chat-payments.jelou.ai/link-webhook?provider=CONEKTA`
* **Name or description:** a descriptive name, for example `Jelou Brain`
* **Events to notify:** select the 5 **orders** events listed above

Confirm the webhook is **Active** in the production environment.

***

## What Brain Studio asks for

When installing Conekta, Brain Studio requests:

| Field | Description |
| - | - |
| **Public key** | Active public key from the environment you are connecting |
| **Private key** | Private key you just created in Conekta |
| **VAT rate** | VAT percentage the integration will use during collection |

> [!NOTE]
>
> VAT is configured during connection in Brain Studio, not in the Conekta panel. The webhook is configured directly in Conekta and is not entered in Brain Studio.

***

## Next step

> [card] [Connect in Brain Studio](https://docs.jelou.ai/en/guides/integrations/payments/providers/conekta/connect-in-brain-studio.md)
>
> Install Conekta using the credentials for the environment you will use and define the VAT rate for the integration.


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