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 — productos, precios, datos del comprador y configuraciones de notificación — y obtienes un init_point para redirigir al comprador al formulario de pago de Mercado Pago.

La Order reemplaza a la preferencia como punto de entrada al checkout. 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 TokenClave privada de la aplicación creada en Mercado Pago, que es utilizada en el backend. Puedes acceder a ella a través de Tus integraciones > Detalles de aplicación > Credenciales de producción. y los parámetros requeridos al endpoint Crear orderAPI y ejecuta la solicitud.

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",
  "total_amount": "1000.00",
  "external_reference": "order_pro_123",
  "payer": {
    "email": "buyer@email.com"
  },
  "transactions": {
    "payments": [
      {
        "amount": "1000.00"
      }
    ]
  },
  "notification_url": "https://www.your-site.com/webhooks"
}'

Al ejecutar la solicitud, la respuesta contendrá el id de la Order y el objeto checkout_pro con la URL del init_point. Esta URL es la dirección a la que debes redirigir al comprador para que acceda al formulario de pago de Mercado Pago y complete la transacción.

Guarda el id de la Order para utilizarlo en operaciones futuras, como consultas de estado, cancelaciones y reembolsos.

json
Copiar
{
  "id": "ORD01HRYFWNYRE1MR1E60MW3X0T2P",
  "type": "online",
  "status": "created",
  "status_detail": "created",
  "external_reference": "order_pro_123",
  "total_amount": "1000.00",
  "checkout_pro": {
    "init_point": "https://www.mercadopago.com.ar/checkout/v1/redirect?pref_id=787997534-6dad21a1-6145-4f0d-ac21-66bf7a5e7a58"
  },
  "transactions": {
    "payments": [
      {
        "id": "pay_01JC1KVZ0WJY8Y4WA7MZG3A8F2",
        "amount": "1000.00",
        "status": "created"
      }
    ]
  }
}

Una vez obtenido el init_point, deberás avanzar a la configuración del frontend. Para eso, 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.

Selecciona el tipo de integración que quieres hacer y sigue los pasos detallados para completar la integración de Checkout Pro.