Obtener order por ID - Orders - Mercado Pago Developers
Obtener order por ID

Consulta toda la información sobre una order utilizando el ID obtenido en la respuesta a su creación. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.

GET

https://api.mercadopago.com/v1/orders/{id}
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
Path
id
string

REQUERIDO

ID de la order, devuelto en la respuesta a la requisición para su creación.
Response parameters
id
string
Identificador de la order creada en la solicitud, generado automáticamente por Mercado Pago.
processing_mode
string
Modo de procesamiento de la order
manual: El procesamiento de la order se hará de manera manual. Es el modo de procesamiento utilizado para la opción "manual", en tanto configura que el procesamiento sea hecho posteriormente, utilizando el endpoint "Procesar order por ID".
automatic: El procesamiento de la order se hará instantáneamente. Es el modo de procesamiento utilizado para la opción "automático".
external_reference
string

REQUERIDO

Es una referencia externa de la order. Puede ser, por ejemplo, un hashcode del Banco Central, funcionando como identificador de origen de la transacción. Este campo debe tener como máximo 64 caracteres y estos solo puede...Ver más
total_amount
string
Monto total a pagar.
Errors

400Error. ID inválido.

invalid_path_param

El order_id proporcionado en el path de la requisición no es correcto. Compruébalo y proporciona un ID válido para volver a intentarlo.

401Error. Access Token no autorizado.

401

El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la requisición enviando el valor correcto.

invalid_credentials

No hay soporte para credenciales de prueba. Use usuarios de prueba con credenciales de producción para el entorno de prueba (sandbox) y sus credenciales de producción para el entorno de producción.

404Error. Order no encontrada.

order_not_found

Order no encontrada. Comprueba si enviaste el ID correcto.

500Error genérico.

internal_error

Error genérico. Intenta enviar la solicitud nuevamente.

Request
curl -X GET \
    'https://api.mercadopago.com/v1/orders/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
    
Response
{
  "id": "ORD01J49MMW3SSBK5PSV3DFR32959",
  "processing_mode": "automatic",
  "external_reference": "ext_ref_1234",
  "total_amount": "50",
  "integration_data": {
    "application_id": "1234",
    "integrator_id": "dev_123",
    "platform_id": "1234567890",
    "sponsor": {
      "id": "446566691"
    }
  },
  "user_id": "12345",
  "created_date": "2024-08-26T13:06:51.045317772Z",
  "last_updated_date": "2024-08-26T13:06:51.045317772Z",
  "country_code": "CL",
  "type": "online",
  "status": "processed",
  "status_detail": "accredited",
  "capture_mode": "automatic_async",
  "total_paid_amount": "50",
  "transactions": {
    "payments": [
      {
        "id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
        "amount": "25",
        "paid_amount": "24.90",
        "date_of_expiration": "2023-03-01T10:00:00.000-04:00",
        "reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
        "status": "processed",
        "status_detail": "accredited",
        "payment_method": {
          "id": "visa",
          "type": "credit_card",
          "token": "12345",
          "installments": 1,
          "statement_descriptor": "My Store",
          "reference": "6005407530",
          "verification_code": "6005407530",
          "financial_institution": "bradesco",
          "digitable_line": "23793380296060054351030006333303799140000020000",
          "qr_code": "00020126580014br.gov.bcb.pix0136b76aa9c2-2ec4-4110-954e-ebfe34f05b61520400005303986540510.005802BR5912TESTPVBWOSBE6009Sao Paulo62240520mpqrinter715936942186304C3C0",
          "qr_code_base64": "iVBORw0KGgoAAAANSUhEUgAABWQAAAVkAQAAAAB79i"
        }
      }
    ],
    "chargebacks": [
      {
        "id": "CBK01J67CQQH5904WDBVZEM4JMEP3",
        "transaction_id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
        "case_id": "1234567890",
        "status": "in_process",
        "references": [
          {}
        ]
      }
    ]
  },
  "description": "Smartphone",
  "items": [
    {
      "title": "Smartphone",
      "unit_price": "25",
      "quantity": 4,
      "description": "Smartphone",
      "external_code": "1234",
      "picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
      "category_id": "MLB1055",
      "type": "MLB1055",
      "warranty": "true",
      "event_date": "2014-06-28T16:53:03.176-04:00"
    }
  ],
  "expiration_time": "P3Y6M4DT12H30M5S",
  "client_token": "QWERTY12345.ASDFG67890",
  "config": {
    "payment_method": {
      "default_type": "credit_card",
      "installments_cost": "seller",
      "installments": {
        "interest_free": {
          "type": "range",
          "values": [
            {}
          ]
        },
        "available": {
          "type": "all"
        }
      }
    }
  }
}