/merchant_orders/:id
BASE URI https://api.mercadopago.com/merchant_orders/{id}
Request Params
ParameterTypeDescription
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)
E-mail del comprador.
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.
shipments
Array(Object)
Información de los envíos.
id
Integer
Identificador del envío.
shipment_type
String
Tipo de envío.
shipping_mode
String
Modo de envío.
picking_type
String
Tipo de retiro de envío.
status
String
Tipo de retiro de envío.
substatus
String
Tipo de retiro de envío.
items
Array(Object)
Ítems a enviar.
date_created
Date(ISO_8601)
Fecha de creación del envío.
last_modified
Date(ISO_8601)
Fecha de última actualización del envío.
date_first_printed
Date(ISO_8601)
Primera fecha de impresión del envío.
service_id
String
Identificador de servicio del envío.
sender_id
Integer
Identificador del emisor.
receiver_id
Integer
Identificador del receptor.
receiver_address
Object
Dirección de envío.
id
Integer
Identifier of receiver address.
address_line
String
Street name and number of receiver address.
apartment
String(256)
Apartmento.
city
Object
Information about receiver address city.
id
String
City Identifier.
name
String
City name.
country
Object
Inforamtion about receiver address country.
id
String
Country identifier.
name
String
Country name.
state
Object
Information about receiver address state.
id
String
State identifier.
name
String
State name.
comment
String
Comment about receiver address.
contact
String
Contact information.
zip_code
String(256)
Código postal.
street_name
String(256)
Calle.
street_number
String(256)
Número.
floor
String(256)
Piso.
phone
String(256)
Receiver address phone.
latitude
String(256)
Receiver address latitude.
longitude
String(256)
Receiver address longitude.
shipping_option
Object
Shipping options.
cost
Float
Net cost absorbed by the receiver.
currency_id
String(3)
Currency identifier.
ARS
Peso argentino.
BRL
Real brasilero.
CLP
Peso chileno.
MXN
Peso mexicano.
COP
Peso colombiano.
PEN
Sol peruano.
UYU
Peso uruguayo.
estimated_delivery
Object
Estimated delivery time information.
date
Date(ISO_8601)
Estimated delivery date.
time_from
String
Estimated lower delivery time.
time_to
String
Estimated upper delivery time.
id
Integer
Shipping option identifier.
list_cost
Float
Net cost of the shipping.
name
String
Option name.
shipping_method_id
Integer
Shipping method identifier.
speed
Object
Shipping time information.
handling
Integer
Handling time.
shipping
Integer
Shipping time.
notification_url
String(500)
URL en la que te gustaría recibir una notificación del estado del pago.
additional_info
String(600)
Información adicional del pago.
external_reference
String(256)
Referencia que puedes sincronizar con tu sistema de pagos.
marketplace
String(256)
Origen del pago. Valor predeterminado: 'NONE'
Error Codes
CodeDescription
400 BAD_REQUEST
invalid_user_id
invalid users involved.
invalid_order_state
invalid_string
string too long.
invalid_application_id
internal server error.
invalid_items
should specify at least one item.
invalid_items
title cannot be null for the given item.
invalid_items
quantity cannot be null for the given item.
invalid_items
invalid item quantity.
invalid_items
cannot operate with this currency code.
invalid_items
invalid unit_price.
invalid_items
some item of the order does not exist.
invalid_items
only the item quantity of an item can be modified.
user_not_allowed
user not allowed to operate.
invalid_payment_id
invalid payment identifier.
invalid_operation_type
invalid operation type.
invalid_payer
invalid payer identifier.
invalid_shipment_id
invalid shipment identifier.
invalid_sponsor_id
invalid sponsor_id.
invalid_marketplace
invalid marketplace.
unmarshall_error
could not unmarshal request body into merchant order struct.
invalid_format
invalid merchant order id.
invalid_url
invalid URL. Isn't HTTP or HTTPS.
communication_error
Error when calling...
401 UNAUTHORIZED
invalid_token
access denied.
invalid_caller_id
invalid caller_id