Obter order por IDhttps://api.mercadopago.com/v1/orders/{order_id}
Consulte todas as informações de uma order utilizando o ID obtido na resposta à sua criação, desde que tenha sido criada há menos de 3 meses. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
GET
Request parameters
Header
Authorization
Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.string
OBRIGATÓRIO
Path
order_id
ID da order, retornado na resposta à requisição para sua criação.string
OBRIGATÓRIO
Response parameters
id
Identificador da order criada na requisição, gerado automaticamente pelo Mercado Pago.string
user_id
ID do usuário do Mercado Pago que criou a order.string
type
Tipo de order.string
point: Order criada para pagamentos com o Mercado Pago Point.
external_reference
É a referência externa da order, atribuída no momento da criação. O limite máximo permitido é de 64 caracteres e os permitidos são: letras maiúsculas e minúsculas, números e os símbolos de hífen (-) e sublinhado (_).string
Erros
400Erro.
bad_request
O order_id fornecido no path da requisição não está correto. Verifique e forneça um ID válido para tentar novamente.
401Erro.
unauthorized
O valor enviado como Access Token está incorreto. Verifique e tente a enviar requisição novamente com o valor correto.
404Erro.
order_not_found
Order não encontrada. Verifique se o ID enviado está correto.
500Erro.
500
Erro interno. Tente enviar a solicitação novamente.
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"
}
]
}