An order is the central resource of the Orders API that unifies the payment lifecycle. When creating an order for Checkout Pro, you define the transaction details, including products, prices, and buyer data, and obtain a checkout_url to redirect the buyer to the Mercado Pago payment form.

From its creation, the order id will be the unique identifier you use to query, cancel, or refund the transaction throughout the entire flow.

To create an order, send a POST with your Test Access TokenTest private key of the application created in Mercado Pago, used in the backend. You can access it through Your integrations > Integration data > Test credentials. and the required parameters to the endpoint Create orderAPI and execute the request. Create one order per payment or transaction flow you want to initiate.

Always include the X-Idempotency-Key header with a unique UUID per attempt to avoid creating duplicate orders.

curl
curl -X POST \
    -H 'accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer ENV_ACCESS_TOKEN' \
    -H 'X-Idempotency-Key: UNIQUE_KEY' \
    'https://api.mercadopago.com/v1/orders' \
    -d '{
  "type": "online",
  "processing_mode": "manual",
  "total_amount": "1000.00",
  "external_reference": "order_pro_123",
  "payer": {
    "email": "buyer@email.com"
  },
  "items": [
    {
      "title": "My product",
      "unit_price": "1000.00",
      "quantity": 1,
      "unit_measure": "unit",
      "total_amount": "1000.00"
    }
  ]
}'

When the request is executed, the response will contain the order id and the checkout_url field with the redirect URL to the Mercado Pago payment form. This URL is the address to which you must redirect the buyer so they can complete the transaction. Save the order id for future operations, such as status queries, cancellations, and refunds. Note that country_code, currency, and the checkout_url domain vary depending on the seller's account country.

json
{
  "id": "ORDTST01KS5AJ6HTK2HRQ3XJ3C2JCKP9",
  "type": "online",
  "processing_mode": "manual",
  "status": "created",
  "status_detail": "created",
  "capture_mode": "automatic_async",
  "external_reference": "order_pro_123",
  "description": "My product",
  "total_amount": "1000.00",
  "total_paid_amount": "0.00",
  "checkout_url": "https://www.mercadopago.com.mx/checkout/v1/redirect?order_id=ORDTST01KS5AJ6HTK2HRQ3XJ3C2JCKP9",
  "client_token": "eyJhbGciOiJSUzI1NiIs...",
  "expiration_time": "P1D",
  "country_code": "MEX",
  "user_id": "1858095454",
  "currency": "MXN",
  "created_date": "2026-05-21T13:10:56.845Z",
  "last_updated_date": "2026-05-21T13:10:56.845Z",
  "integration_data": {
    "application_id": "8772548647196351"
  },
  "config": {
    "online": {
      "retries": {
        "allowed": false
      }
    },
    "payment_method": {}
  },
  "items": [
    {
      "title": "My product",
      "unit_price": "1000.00",
      "quantity": 1,
      "unit_measure": "unit",
      "total_amount": "1000.00"
    }
  ]
}

See the table below for a description of the main fields returned in the response.

With the checkout_url available, the next step is to redirect the buyer to the checkout. Go to Redirect the buyer to the checkout to continue the integration. If you want, you can also see below how to manage the order once it is created.

Once the order is created, you can check its status or search for it at any time using the id returned in the response. Use the following endpoints:

• Get order by IDAPI
• Search ordersAPI

Choose the integration type that best suits your needs, whether for a website or a mobile application, and follow the detailed steps to complete the Checkout Pro integration.