/merchant_orders/search
BASE URI https://api.mercadopago.com/merchant_orders/search
HTTP Request
curl
curl -X GET \
'https://api.mercadopago.com/merchant_orders?status=&preference_id=&application_id=&payer_id=&sponsor_id=&external_reference=&site_id=&marketplace=&date_created_from=&date_created_to=&last_updated_from=&last_updated_to=&items=&limit=&offset=&order_status=' \
-H 'Authorization: Bearer ACCESS_TOKEN_ENV'
Request Params
ParameterTypeDescription
preference_id
String(UUID)
Identificador de la preferencia de pago asociado a la orden.
date_created
Date(ISO_8601)
Fecha de creación de la orden.
last_updated
Date(ISO_8601)
Fecha de última actulización de la orden.
application_id
String
Identificador de aplicación.
status
String
Muestra el estado actual de la orden.
opened
Orden sin pagos.
closed
Orden con pagos que cubren el monto total.
expired
Orden cancelada (cancelled: true) que no posee pagos aprobados ni pendientes (todos rechazados o devueltos).
site_id
String
Identificador de país al que pertenece la orden.
payer
Object
Información del comprador.
id
Integer
Identificador del comprador.
email
String(256)
Campo deprecado, responderá una cadena vacía.
nickname
String(256)
Nickname del comprador.
sponsor_id
Integer
Identificador del sponsor en Mercado Pago.
items
Array(Object)
Información de los ítems.
id
String
Identificador del ítem.
put
Requerido en PUT
category_id
String
Category del ítem.
currency_id
String(3)
Identificador de la moneda utilizada en el precio del ítem.
ARS
Peso argentino.
BRL
Real brasilero.
CLP
Peso chileno.
MXN
Peso mexicano.
COP
Peso colombiano.
PEN
Sol peruano.
UYU
Peso uruguayo.
description
String
Descripción del ítem.
picture_url
String
URL de imagen del ítem.
quantity
Integer
Cantidad de items.
put
Este es el único campo de ítem que puede ser modificado con un put put
unit_price
Float
Precio unitario del ítem.
title
String
Título del ítem.
external_reference
String(256)
Referencia que puedes sincronizar con tu sistema de pagos.
marketplace
String(256)
Origen del pago. Valor predeterminado: 'NONE'
order_status
String
Estado actual de la orden según el estado de los pagos.
payment_required
Orden sin ningún pago o con todos los pagos "rejected" o "cancelled".
reverted
Orden con todos los pagos en "refunded" o "chargeback".
paid
Orden con la suma de todos los pagos "approved", "chargeback" o "in_mediation" cubre el monto total de la orden.
partially_reverted
Orden con al menos un pago en "refunded" o "chargeback".
partially_paid
Orden con al menos un pago en "approved" y no cubre el total de la orden.
payment_in_process
Orden con pagos "in_process", "pending" or "authorized".
undefined
Orden creada antes de la existencia del estado order_status.
expired
Orden cancelada (cancelled: true) que no posee pagos aprobados ni pendientes (todos rechazados o devueltos).
HTTP Response
json
{
"elements": [
{
"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": "[FAKER][CURRENCY][ACRONYM]",
"status": "approved",
"status_detail": "accredited",
"operation_type": "regular_payment",
"date_approved": "2019-04-02T14:35:35.000-04:00",
"date_created": "2019-04-02T14:35:34.000-04:00",
"last_modified": "2019-04-02T14:35:35.000-04:00",
"amount_refunded": 0
}
],
"shipments": [
{
"id": 99999999999,
"shipment_type": "shipping",
"shipping_mode": "me2",
"picking_type": null,
"status": "delivered",
"substatus": null,
"items": [
{
"id": "not specified",
"description": "shipment item description",
"quantity": 1,
"dimensions": "1.0x10.0x23.0,100.0",
"dimensions_source": null
}
],
"date_created": "2019-04-02T14:20:46.000-04:00",
"last_modified": "2019-04-12T15:36:48.000-04:00",
"date_first_printed": "2019-04-02T14:35:40.000-04:00",
"service_id": 999,
"sender_id": 999999999,
"receiver_id": 999999999,
"receiver_address": {
"id": 9999999999,
"address_line": "address line",
"city": {
"id": null,
"name": "City Name"
},
"state": {
"id": "AR-X",
"name": "state name"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": "0.000000",
"longitude": "0.000000",
"comment": "shipment comment",
"contact": "shipment contact",
"phone": "9999999999",
"zip_code": "9999",
"street_name": "Street name",
"street_number": "999",
"floor": null,
"apartment": null
},
"shipping_option": {
"id": 999999999,
"cost": 0,
"currency_id": "[FAKER][CURRENCY][ACRONYM]",
"shipping_method_id": 99999,
"estimated_delivery": {
"date": "2019-04-11T00:00:00.000-03:00",
"time_from": null,
"time_to": null
},
"name": "Normal a domicilio",
"list_cost": 0,
"speed": {
"handling": 72,
"shipping": 72
}
}
}
],
"collector": {
"id": 999999999,
"nickname": null
},
"marketplace": "NONE",
"notification_url": null,
"date_created": "2018-09-14T13:11:31.000-04:00",
"last_updated": "2018-09-14T13:11:43.000-04:00",
"sponsor_id": null,
"shipping_cost": 0,
"total_amount": 5,
"site_id": "MLA",
"paid_amount": 5,
"refunded_amount": 0,
"payer": {
"id": 999999999,
"email": ""
},
"items": [
{
"id": "item id",
"category_id": "item category",
"currency_id": "[FAKER][CURRENCY][ACRONYM]",
"description": "item description",
"picture_url": "item picture url",
"title": "item title",
"quantity": 1,
"unit_price": 5
}
],
"cancelled": false,
"additional_info": "additional information",
"application_id": 9999999999999999,
"order_status": "paid"
}
],
"next_offset": 1,
"total": 1
}
Error Codes
CodeDescription
400 BAD_REQUEST
ds_search_query
invalid query.
401 UNAUTHORIZED
invalid_token
invalid_token.
invalid_caller_id
invalid caller_id