Conekta
Connect Conekta to PayLexer to accept card, OXXO cash, and SPEI bank transfer payments in Mexico through an embedded checkout widget with RSA-signed webhooks.
Conekta is a Mexican payment processor focused exclusively on payment methods used by Mexican shoppers. Alongside card payments, it supports SPEI bank transfers and OXXO cash payments, giving customers without a credit card a way to complete purchases at OXXO convenience stores across Mexico. PayLexer connects to Conekta's embedded checkout widget, so shoppers select and complete their payment method inline without leaving the site.
- Supported Regions (Merchant Accounts): Mexico
- Supported Currencies: MXN
This gateway appears in checkout only when the selected currency is MXN.
Supported Features
- Embedded checkout widget presenting card, OXXO cash, and SPEI bank transfer as selectable payment methods, with no redirect away from the site
- Recurring subscriptions with optional free trials and sign-up fees
- Refunds processed directly from PayLexer
- RSA-SHA256 signed webhooks for real-time, server-to-server payment confirmation
Before You Start
Make sure you have:
- Conekta Account – Don't have one? Sign up for Conekta →
- PayLexer Account – Required to configure the integration. Create your account →
- A website where you want to integrate
Looking for a different payment processor? View all supported gateways →
Configuring Conekta
You need an API Key and Public Key from Conekta for this integration.
Getting API Credentials
Open the Conekta Panel
Log in to your Conekta Panel.
Go to API Keys
Navigate to Developers → View API Keys.
If this is a new account, no keys exist yet. Click Create new private key, enter a name or description for the key, then click Create key.
Copy your API Key and Public Key
Copy the Private Key (entered as the API Key in PayLexer) and the Public Key for the environment you are setting up.
- Switch the panel's Test Mode toggle to generate and view Test keys instead of Live keys.
Treat the Private Key like a password. Anyone with it can create charges and refunds on your Conekta account.
Adding Credentials to PayLexer
Open PayLexer Dashboard
Log in to your PayLexer dashboard and navigate to Payment Gateways → Conekta.
Enter your credentials
Paste the API Key and Public Key you copied from Conekta.
Understanding Live/Production and Sandbox Settings:
| Environment | Purpose |
|---|---|
| Live / Production (Mandatory) | Used for real transactions. Cannot be empty, even when testing. |
| Test / Sandbox (Optional) | Used for testing only. No real money is processed. |
How PayLexer selects credentials:
- Debug/Test mode ON → Test credentials are used
- Debug/Test mode OFF → Live credentials are used
Test and save
Click Test Connection to verify your credentials, then click Save Configuration.
Configuring Webhooks (Mandatory)
Webhooks enable real-time payment updates and significantly improve reliability.
Benefits of Webhooks:
- Instant payment status updates
- Automatic refund processing
- Dispute notifications
Conekta signs the raw webhook payload with RSA-SHA256 and sends the base64 signature in a Digest header. Instead of a shared secret, you generate an RSA verification key for the endpoint, which PayLexer stores as the Webhook Secret.
Copy your PayLexer webhook URL
In PayLexer → Payment Gateways → Conekta, copy the Webhook URL shown for your account.
Create the webhook in Conekta
In the Conekta Panel, go to Developer → View webhooks → Create webhook and paste the PayLexer webhook URL as the Webhook URL. Also give a proper name or description of the webhook.
Select payment and subscription events
Subscribe to the order events (order.paid, order.declined, order.refunded, order.partially_refunded) and subscription events (subscription.paid, subscription.payment_failed, subscription.canceled) in the events to notify section field, then click on Create webhook.
Add the Webhook Secret to PayLexer
Copy the secret key Conekta generates for the webhook, then paste it into the Webhook Secret field in PayLexer and click Save Configuration.
Paste the full verification key exactly as provided, including its PEM header and footer lines. A truncated key fails signature validation.
Integrate Conekta to Your Website
If you have already added and configured your site, you can enable Conekta in your existing setup.
Go to Websites
Navigate to Websites in your PayLexer dashboard.
Edit your website
Click the Edit Icon of your added website.
Enable Conekta
Click the checkbox to enable Conekta for the website.
If you haven't added a website yet, Continue to Add Your Website →
Troubleshooting
Best Practices
- Test in sandbox before enabling production. Use Test Mode keys and Conekta's test cards to complete a full payment before switching to live.
- Configure webhooks so payment, refund, and subscription updates sync in real time, since OXXO and SPEI confirmations can arrive well after the order is created.
- Keep your API Key and Webhook Secret confidential, and regenerate them if you suspect exposure.
- Monitor pending orders in the Conekta Panel to catch OXXO and SPEI payments approaching their expiration window.
FAQs
Still Have Questions?
- Conekta Support: Conekta Support
- PayLexer Support: Contact Support