Obter pedido comercialhttps://api.mercadopago.com/merchant_orders/{id}
Veja todas as informações de pagamento de um produto ou serviço com a identificação do pedido de sua escolha.
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
id
Identificador único do pedido gerado pelo Mercado Pagonumber
OBRIGATÓRIO
Response parameters
id
Identificador único do pedido gerado pelo Mercado Pagonumber
status
Exibe o estado atual da ordemstring
opened: Pedido sem pagamentos.
closed: Pedido com pagamentos que cobrem o valor total.
expired: Pedido cancelado que não possui pagamentos aprovados ou pendentes (todos rejeitados ou devolvidos).
external_reference
Identificador único enviado pelo vendedor para relacionar o order_id gerado pelo Mercado Pago ao ID do seu sistema de pagamentostring
preference_id
Identificador da preferência de pagamento associada ao pedidostring
Erros
400Erro
invalid_format
invalid caller.id.
401Erro
invalid_token
access denied.
invalid_caller_id
invalid caller_id
Informe dados válidos nos request parameters antes de executar.
Request
curl -X GET \
'https://api.mercadopago.com/merchant_orders/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
Response
{
"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": {
"en": "Street name",
"pt": "Nome da rua",
"es": "Nombre de la calle"
},
"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": "test_user_co@testuser.com",
"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,
"email": "test_user_co@testuser.com"
},
"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
}
],
"canceled": false,
"additional_info": "additional information",
"application_id": "10000000000000000",
"order_status": "paid"
}