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
Errores
400Error.
invalid_path_param
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.
Request
curl -X GET \
'https://api.mercadopago.com/v1/orders/{order_id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
Response
{
"id": "ORD00001111222233334444555566",
"user_id": "5238400195",
"type": "point",
"external_reference": "ext_ref_1234",
"expiration_time": "PT16M",
"processing_mode": "automatic",
"description": "Smartphone",
"country_code": "AR",
"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": {
"screen_time": "PT15S",
"terminal_id": "PAX_N950__SMARTPOS1423",
"print_on_terminal": "no_ticket",
"ticket_number": "S0392JED"
},
"payment_method": {
"default_type": "credit_card"
}
},
"transactions": {
"payments": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24",
"refunded_amount": "38",
"paid_amount": "38",
"status": "refunded",
"status_detail": "created",
"reference_id": "12345678",
"payment_method": {
"type": "credit_card",
"installments": 1,
"id": "master"
}
}
],
"refunds": [
{
"id": "REF01J67CQQH5904WDBVZEM1234D",
"transaction_id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"reference_id": "12345678",
"amount": "47.28",
"status": "processed"
}
]
}
}