Una order es el recurso central de la API de Orders que unifica el ciclo de vida del pago. Al crear una order para Checkout Pro, defines los detalles de la transacción, incluyendo productos, precios y datos del comprador, y obtienes un checkout_url para redirigir al comprador al formulario de pago de Mercado Pago.

A partir de su creación, el id de la order será el identificador único que utilizarás para consultar, cancelar o reembolsar la transacción a lo largo de todo el flujo.

Para crear una order, envía un POST con tu Access Token de pruebaClave privada de prueba de la aplicación creada en Mercado Pago, que es utilizada en el backend. Puedes acceder a ella a través de Tus integraciones > Datos de la integración > Credenciales de prueba. y los parámetros requeridos al endpoint Crear orderAPI y ejecuta la solicitud. Crea una order por cada flujo de pago o transacción que quieras iniciar.

Incluye siempre el encabezado X-Idempotency-Key con un UUID único por intento para evitar la creación de orders duplicadas.

curl
Copiar
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": "Mi producto",
      "unit_price": "1000.00",
      "quantity": 1,
      "unit_measure": "unit",
      "total_amount": "1000.00"
    }
  ]
}'

Al ejecutar la solicitud, la respuesta contendrá el id de la order y el campo checkout_url con la URL de redirección al formulario de pago de Mercado Pago. Esta URL es la dirección a la que debes redirigir al comprador para que complete la transacción. Guarda el id de la order para utilizarlo en operaciones futuras, como consultas de estado, cancelaciones y reembolsos. Ten en cuenta que los valores de country_code y currency varían según el país de la cuenta del vendedor.

json
Copiar
{
  "id": "ORDTST01KS5AJ6HTK2HRQ3XJ3C2JCKP9",
  "type": "online",
  "processing_mode": "manual",
  "status": "created",
  "status_detail": "created",
  "capture_mode": "automatic_async",
  "external_reference": "order_pro_123",
  "description": "Mi producto",
  "total_amount": "1000.00",
  "total_paid_amount": "0.00",
  "checkout_url": "https://www.mercadopago.com.ar/checkout/v1/redirect?order_id=ORDTST01KS5AJ6HTK2HRQ3XJ3C2JCKP9",
  "client_token": "eyJhbGciOiJSUzI1NiIs...",
  "expiration_time": "P1D",
  "country_code": "ARG",
  "user_id": "1858095454",
  "currency": "ARS",
  "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": "Mi producto",
      "unit_price": "1000.00",
      "quantity": 1,
      "unit_measure": "unit",
      "total_amount": "1000.00"
    }
  ]
}

Consulta en la tabla a continuación la descripción de los principales campos devueltos en la respuesta.

Con el checkout_url disponible, el siguiente paso es configurar el frontend para redirigir al comprador.

Una vez creada la order, puedes consultar su estado o buscarla en cualquier momento utilizando el id devuelto en la respuesta. Para eso, utiliza los siguientes endpoints:

• Obtener order por IDAPI
• Buscar ordersAPI

Elige el tipo de integración que mejor se adapte a tus necesidades, ya sea para un sitio web o una aplicación móvil, y sigue los pasos detallados para completar la integración de Checkout Pro.