Update an order/merchant_orders/{id}Renew the details of a payment. Indicate the ID of the order and send the parameters with the information you want to update.
PUT
Request's parameters
idnumber
Localization: pathOrder identifierREQUIRED
additional_info
Localization: bodyAdditional informationstring
application_id
Localization: bodyapplication identifierstring
external_reference
Localization: bodyReference you can synchronize with your payment systemstring
Response parameters
id
Localization: bodyidnumber
status
Localization: bodyShow the current merchant order statestring
opened: Order without payments.
closed: Order with payments covering total amount.
expired: Canceled order that does not have approved or pending payments (all rejected or returned).
external_reference
Localization: bodyexternal_referencestring
preference_id
Localization: bodypreference_idstring
Request
curl
curl -X PUT \
'https://api.mercadopago.com/merchant_orders/{id}' \
-H 'Authorization: Bearer ACCESS_TOKEN_ENV' \
-d '{
"external_reference": "default",
"preference_id": "Preference identification",
"payer": {
"id": 123,
"nickname": "JOHN"
},
"site_id": "MLA",
"items": [
{
"id": "item id",
"category_id": "item category",
"currency_id": "BRL",
"description": "item description",
"picture_url": "item picture",
"quantity": 1,
"unit_price": 5,
"title": "item title"
}
],
"application_id": 10000000000000000
}'
Answer
json
{
"id": 9999999999,
"status": "closed",
"external_reference": "default",
"preference_id": "Preference identification",
"payments": {},
"shipments": {},
"payouts": {},
"collector": {
"id": 999999999,
"email": "",
"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
},
"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
}
],
"cancelled": false,
"additional_info": "additional information",
"application_id": 10000000000000000,
"order_status": "paid"
}
Errors
400bad_request
invalid_user_id
invalid_order_state
invalid_string
invalid_application_id
invalid_items
user_not_allowed
invalid_payment_id
invalid_operation_type
invalid_payer
invalid_shipment_id
invalid_sponsor_id
invalid_marketplace
unmarshall_error
invalid_format
invalid_url
communication_error
401bad_request
invalid_token
invalid_caller_id
Was this information helpful?