Obtener orden comercialhttps://api.mercadopago.com/merchant_orders/{id}
Consulta toda la información de pago de un producto o servicio con el ID de la orden que quieras.
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
id
Identificador único de la orden generada por Mercado Pagonumber
REQUERIDO
Response parameters
id
Identificador único de la orden generada por Mercado Pagonumber
status
Muestra el estado actual de la ordenstring
opened: Orden sin pagos.
closed: Orden con pagos que cubren el monto total.
expired: Orden cancelada que no tiene pagos aprobados o pendientes (todos rechazados o devueltos).
external_reference
Identificador único que envía el vendedor para relacionar la order_id generada por Mercado Pago, con el id de su sistema de pagosstring
preference_id
Identificador de la preferencia de pago asociado a la ordenstring
Errores
400Error
invalid_format
invalid caller.id.
401Error
invalid_token
access denied.
invalid_caller_id
invalid caller_id
Informa datos válidos en los request parameters antes de la ejecución.
Request
curl -X GET \
'https://api.mercadopago.com/merchant_orders/{id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
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_ar@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_ar@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"
}