Obtener order por IDhttps://api.mercadopago.com/v1/orders/{order_id}
Consulta toda la información sobre una order utilizando el ID obtenido en la respuesta a su creación, siempre que haya sido creada hace menos de 3 meses. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.
GET
Request parameters
Header
Authorization
Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.string
REQUERIDO
Path
order_id
ID de la order, devuelto en la respuesta a la petición para su creación.string
REQUERIDO
Response parameters
id
Identificador de la order creada en la solicitud, generado automáticamente por Mercado Pago.string
user_id
Identificador del usuario de Mercado Pago que creó la order.string
type
Tipo de order.string
point: Order creada para pagos con Mercado Pago Point.
external_reference
Es una referencia externa de la order, asignada al momento de su creación. El lÃmite máximo permitido es de 64 caracteres y los permitidos son: letras mayúsculas y minúsculas, números y los sÃmbolos de guion (-) y guion ...Ver másstring
Errors
400Error.
bad_request
El order_id proporcionado en el path de la petición no es correcto. Compruébalo y proporciona un ID válido para volver a intentarlo.
401Error.
unauthorized
El valor enviado como Access Token es incorrecto. Por favor, verifÃcalo y vuelve a intentar realizar la peticion enviando el valor correcto.
404Error.
order_not_found
Order no encontrada. Comprueba si enviaste el ID correcto.
500Error.
500
Error interno. Intenta enviar la solicitud nuevamente.
Informa datos válidos en los request parameters antes de la ejecución.
Request
curl -X GET \
'https://api.mercadopago.com/v1/orders/{order_id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
Response
{
"id": "ORD00001111222233334444555566",
"user_id": "5238400195",
"type": "point",
"external_reference": "ext_ref_1234",
"expiration_time": "PT16M",
"processing_mode": "automatic",
"description": "Smartphone",
"country_code": "CL",
"integration_data": {
"application_id": "1234567890",
"platform_id": "dev_1234567890",
"integrator_id": "dev_123456",
"sponsor": {
"id": "446566691"
}
},
"status": "refunded",
"status_detail": "refunded",
"created_date": "2024-09-10T14:26:42.109320977Z",
"last_updated_date": "2024-09-10T14:26:42.109320977Z",
"config": {
"point": {
"terminal_id": "NEWLAND_N950__N950NCB801293324",
"print_on_terminal": "no_ticket"
},
"payment_method": {
"default_type": "credit_card"
}
},
"transactions": {
"payments": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "25",
"refunded_amount": "38",
"tip_amount": "14",
"paid_amount": "50",
"status": "refunded",
"status_detail": "created",
"reference_id": "12345678",
"payment_method": {
"type": "credit_card",
"installments": 1,
"id": "master"
},
"card": {
"first_digits": "credit_card",
"last_digits": "credit_card"
}
}
],
"refunds": [
{
"id": "REF01J67CQQH5904WDBVZEM1234D",
"transaction_id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"reference_id": "12345678",
"amount": "25",
"status": "processed"
}
]
},
"taxes": [
{
"payer_condition": "payment_taxable_iva"
}
]
}