Skip to main content
This guide walks you through preparing credentials and webhooks for test and production in the Conekta panel.
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 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.
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.
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:
Select these 5 events within the orders category:
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/ 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

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

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

Create Webhook modal in Conekta

Conekta webhook event selector with order.expired, order.paid, order.pending_payment, order.refunded, and order.declined selected

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

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

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

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

Connect in Brain Studio

Install Conekta using the credentials for the environment you will use and define the VAT rate for the integration.