/merchant_orders/:id
BASE URI https://api.mercadopago.com/merchant_orders/{id}
HTTP Request
curl
curl -X PUT \
'https://api.mercadopago.com/merchant_orders/{id}' \
-H 'Authorization: Bearer ACCESS_TOKEN_ENV'
Request Params
ParameterTypeDescription
site_id
String
Country identifier that merchant order belongs to.
payer
Object
Buyer Information.
id
Integer
Buyer id.
email
String(256)
Deprecated field, will return an empty string.
nickname
String(256)
Buyer nickname.
sponsor_id
Integer
Sponsor ID in Mercado Pago.
items
Array(Object)
items information.
id
String
Item id.
put
Required in PUT
category_id
String
Item category.
currency_id
String(3)
ID of the currency used in the item price.
ARS
Argentine peso.
BRL
Brasil real.
CLP
Chilean peso.
MXN
Mexican peso.
COP
Colombian peso.
PEN
Peruvian sol.
UYU
Uruguayan peso.
description
String
Item description.
picture_url
String
Item picture URL.
quantity
Integer
Item quantity.
put
This is the only field of item that can be modified in put
unit_price
Float
Item unit price.
title
String
Item title.
shipments
Array(Object)
Shipments information.
id
Integer
Shipping identifier.
shipment_type
String
Shipping type.
shipping_mode
String
Shipping mode.
picking_type
String
Shipping picking type.
status
String
Shipping picking type.
substatus
String
Shipping picking type.
items
Array(Object)
Shipping items.
date_created
Date(ISO_8601)
Shipping's creation date.
last_modified
Date(ISO_8601)
Shipping's last modification date.
date_first_printed
Date(ISO_8601)
Shipping's first printed date.
service_id
String
Shipping service identifier.
sender_id
Integer
Sender identifier.
receiver_id
Integer
Receiver identifier.
receiver_address
Object
Shipping address.
id
Integer
Identifier of receiver address.
address_line
String
Street name and number of receiver address.
apartment
String(256)
Apartment.
city
Object
Information about receiver address city.
id
String
City identifier.
name
String
City name.
country
Object
Information 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)
Zip code.
street_name
String(256)
Street name.
street_number
String(256)
Street number.
floor
String(256)
Floor.
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
Argentine peso.
BRL
Brasil real.
CLP
Chilean peso.
MXN
Mexican peso.
COP
Colombian peso.
PEN
Peruvian sol.
UYU
Uruguayan peso.
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 where you'd like to receive a payment notification.
additional_info
String(600)
Additional information.
external_reference
String(256)
Reference you can synchronize with your payment system.
marketplace
String(256)
Origin of the payment. Default value: '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