Obtener orden - Órdenes comerciales - Mercado Pago Developers
Obtener orden

GET

/merchant_orders/{id}
Consulta toda la información de pago de un producto o servicio con el ID de la orden que quieras.
Parámetros para la solicitud
id

REQUERIDO

number
Localización: pathIdentificador único de la orden generada por Mercado Pago
Parámetros de respuesta
id
number
Localización: bodyIdentificador único de la orden generada por Mercado Pago
status
string
Localización: bodyMuestra el estado actual de la orden
opened: Orden sin pagos.
closed: Orden con pagos que cubren el monto total.
expired: Orden cancelada que no posee pagos aprobados ni pendientes (todos rechazados o devueltos).
external_reference
string
Localización: bodyIdentificador único que envía el vendedor para relacionar la order_id generada por Mercado Pago, con el id de su sistema de pagos
preference_id
string
Localización: bodyIdentificador de la preferencia de pago asociado a la orden
Solicitud
curl
curl -X GET \
    'https://api.mercadopago.com/merchant_orders/{id}' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' 
Respuesta
json
{
  "id": 9999999999,
  "status": "closed",
  "external_reference": "default",
  "preference_id": "Preference identification",
  "payments": [
    {
      "id": 9999999999,
      "transaction_amount": 1,
      "total_paid_amount": 1,
      "shipping_cost": 0,
      "currency_id": "BRL",
      "status": "approved",
      "status_detail": "accredited",
      "date_approved": "2019-04-02T18:35:35.000Z",
      "date_created": "2019-04-02T18:35:34.000Z",
      "last_modified": "2019-04-02T18:35:35.000Z",
      "amount_refunded": 0
    }
  ],
  "shipments": [
    {
      "id": 99999999999,
      "shipment_type": "shipping",
      "shipping_mode": "me2",
      "status": "delivered",
      "items": [
        {
          "id": "not specified",
          "description": "shipment item description",
          "quantity": 1,
          "dimensions": "1.0x10.0x23.0100.0"
        }
      ],
      "date_created": "2019-04-02T18:20:46.000Z",
      "last_modified": "2019-04-12T19:36:48.000Z",
      "date_first_printed": "2019-04-02T18:35:40.000Z",
      "service_id": 999,
      "sender_id": 999999999,
      "receiver_id": 999999999,
      "receiver_address": {
        "id": 9999999999,
        "address_line": "address line",
        "city": {
          "name": "City Name"
        },
        "state": {
          "id": "AR-X",
          "name": "state name"
        },
        "country": {
          "id": "AR",
          "name": "Argentina"
        },
        "latitude": 0,
        "longitude": 0,
        "comment": "shipment comment",
        "contact": "shipment contact",
        "phone": 9999999999,
        "zip_code": 9999,
        "street_name": "Street name",
        "street_number": 999
      },
      "shipping_option": {
        "id": 999999999,
        "cost": 0,
        "currency_id": "BRL",
        "shipping_method_id": 99999,
        "estimated_delivery": {
          "date": "2019-04-11T03:00:00.000Z"
        },
        "name": "Normal a domicilio",
        "list_cost": 0,
        "speed": {
          "handling": 72,
          "shipping": 72
        }
      }
    }
  ],
  "payouts": {},
  "collector": {
    "id": 999999999,
    "email": "vendedor+329653108@adf12.com.br",
    "nickname": "TESTRPEHE21Q"
  },
  "marketplace": "NONE",
  "date_created": "2018-09-14T17:11:31.000Z",
  "last_updated": "2018-09-14T17:11:43.000Z",
  "shipping_cost": 0,
  "total_amount": 5,
  "site_id": "mla",
  "paid_amount": 5,
  "refunded_amount": 0,
  "payer": {
    "id": 999999999
  },
  "items": [
    {
      "id": "item id",
      "category_id": "item category",
      "currency_id": "BRL",
      "description": "item description",
      "picture_url": "item picture url",
      "title": "item title",
      "quantity": 1,
      "unit_price": 5
    }
  ],
  "cancelled": false,
  "additional_info": "additional information",
  "application_id": 10000000000000000,
  "order_status": "paid"
}
Errores
400bad_request
invalid_formatinvalid_format--invalid caller.id.
401bad_request
invalid_tokeninvalid_token--access denied.
invalid_caller_idinvalid_caller_id--invalid caller_id