/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
Identificador do país a que pertence a ordem.
payer
Object
Informação do comprador.
id
Integer
Id do comprador.
email
String(256)
Deprecated field, will return an empty string.
nickname
String(256)
Nick do comprador.
sponsor_id
Integer
Sponsor ID in Mercado Pago.
items
Array(Object)
Informação do item.
id
String
Id do anúncio.
put
Required in PUT
category_id
String
Categoria do item.
currency_id
String(3)
Identificador da moeda utilizada no preço do item.
ARS
Argentine peso.
BRL
Brasil real.
CLP
Chilean peso.
MXN
Mexican peso.
COP
Colombian peso.
PEN
Peruvian sol.
UYU
Uruguayan peso.
description
String
Descrição do anúncio.
picture_url
String
URL da imagem do anúncio.
quantity
Integer
Item quantity.
put
This is the only field of item that can be modified in put
unit_price
Float
Preço unitário do item.
title
String
Título do item.
shipments
Array(Object)
Shipments information.
id
Integer
Id do frete.
shipment_type
String
Tipo de transporte.
shipping_mode
String
Modo de envio.
picking_type
String
Taxa de remoção de envio.
status
String
Taxa de remoção de envio.
substatus
String
Taxa de remoção de envio.
items
Array(Object)
Itens a enviar.
date_created
Date(ISO_8601)
Data de criação do frete.
last_modified
Date(ISO_8601)
Data da última atualização do frete.
date_first_printed
Date(ISO_8601)
Primeira data de impressão do frete.
service_id
String
Identificador de serviço do transporte.
sender_id
Integer
Id do remetente.
receiver_id
Integer
Id do receptor.
receiver_address
Object
Endereço de envio.
id
Integer
Identifier of receiver address.
address_line
String
Street name and number of receiver address.
apartment
String(256)
Apartamento.
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)
Código postal.
street_name
String(256)
Rua.
street_number
String(256)
O Número.
floor
String(256)
Apartamento.
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 em que você gostaria de receber uma notificação de status de pagamento.
additional_info
String(600)
Informações adicionais do pagamento.
external_reference
String(256)
Referência que pode sincronizar com seu sistema de pagamentos.
marketplace
String(256)
Origem do pagamento. Valor padrão: '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 nos 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