Busca inteligente powered by OpenAI
Obter order por ID
GET
Produtos relacionados:
Parâmetros de requisição
PATH
id
ID da order, retornado na resposta à requisição para sua criação.string
OBRIGATÓRIO
Parâmetros de resposta
id
Identificador da order criada na requisição, gerado automaticamente pelo Mercado Pago.string
processing_mode
Modo de processamento da orderstring
manual: O processamento da order será realizado manualmente. É o modo de processamento utilizado para a opção "manual", enquanto configura o processamento para ser feito posteriormente, utilizando o endpoint "Processar order por ID".
automatic: O processamento da order será feito imediatamente. É o modo de processamento utilizado para a opção "automático".
external_reference
Referência externa da order. Pode ser, por exemplo, um hashcode do Banco Central, funcionando como identificador de origem da transação. Este campo deve ter no máximo 64 caracteres e deve conter apenas números, letras, h...Ver maisstring
OBRIGATÓRIO
total_amount
Valor total a ser pago. Deve ser enviado com duas casas decimais.string
Erros
400Erro. ID inválido.
invalid_path_param
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. Access Token não autorizado.
401
O Access Token enviado está incorreto. Revise o valor e tente enviar a requisição novamente com a informação correta.
404Error. Order não encontrada.
order_not_found
Order não encontrada. Verifique se o ID enviado está correto.
500Erro genérico.
500
Erro genérico. Tente fazer uma nova requisição.
Requisição
curl -X GET \
'https://api.mercadopago.com/v1/orders/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
Resposta de exemplo
{
"id": "123",
"processing_mode": "automatic",
"external_reference": "ext_ref_1234",
"total_amount": "24.90",
"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": "BRA",
"type": "online",
"status": "processed",
"status_detail": "accredited",
"capture_mode": "manual",
"transactions": {
"payments": [
{
"id": "pay_01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24.90",
"status": "processed",
"status_detail": "accredited",
"payment_method": {
"id": "visa",
"type": "credit_card",
"token": "12345",
"installments": 1,
"statement_descriptor": "approved"
}
}
]
},
"description": "Point Mini",
"marketplace": "MERCADOLIVRE",
"items": [
{
"title": "Point Mini",
"unit_price": "12.90",
"quantity": 4,
"description": "Point product for card payments via Bluetooth.",
"id": "1234",
"picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
"category_id": "MLB1055"
}
],
"expiration_time": "P3Y6M4DT12H30M5S"
}