Step 1

Add your private key and API version.

You need your private test key. You can find it in your admin.

Step 2

Create an order

If you include a payment source in your request to create an order, Conekta immediately returns your payment reference. In some cases you may want to add or remove items or change information before charging your customer, in that case omit the charge details and send them when your are ready to complete it.

Creating an ordergenerates a charge to your client. If you do not want to create a charge immediately, you can prepare an order and generate the charge later by sending the charges array information.

It is important that all information sent to Conekta be correct as helps approve payments and comply with regulations related to money laundering.

The minimum required fields are shown in the example, if you want to know more about the object order, review our REST API documentation.

Step 3

Process responses

Once you have created an order and a charge, you must process the response and present an OXXO PAY stub.

Remember that the order response is in JSON format.

Step 4

Present the OXXO PAY Stub

Use this pay stub to give your client their payment reference and necessary steps to complete their purchase.


Include an OXXO PAY stub in your checkout or send it by email to offer a better experience.

Check out the GitHub repo.

Step 5

Recieve notifications

Add a Webhook in your Conekta Admin to be able to confirm OXXO PAY payments, these allow you to receive the POST (HTTP JSON) notifications correctly.

Use public URLs: If you do not have a public IP address or domain, you can use services such as Ultrahook or Localtunnel. Check our webhooks reference here.

Step 6

Notify your client

Step 7

Test your webhook

In your Conekta Admin you can test the funcionality of your webhook.

You will need: The URL of your webhook and access to Conekta Admin.

That's it! Please remember to exchange your sandbox keys for the production keys.