Atualizar pedido/merchant_orders/{id}Atualizar os dados de um pagamento. Indique o ID da ordem e envie as informações que você deseja atualizar.
PUT
Produtos relacionados:
Parâmetros de requisição
idnumber
Localização: pathIdentificador único do pedido gerado pelo Mercado PagoOBRIGATÓRIO
additional_info
Localização: bodyInformações adicionaisstring
application_id
Localização: bodyId do aplicativostring
external_reference
Localização: bodyIdentificador único enviado pelo vendedor para relacionar o order_id gerado pelo Mercado Pago ao ID do seu sistema de pagamentostring
Parâmetros de resposta
id
Localização: bodyIdentificador único do pedido gerado pelo Mercado Pagonumber
status
Localização: bodyExibe o estado atual da ordemstring
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
Localização: bodyIdentificador único enviado pelo vendedor para relacionar o order_id gerado pelo Mercado Pago ao ID do seu sistema de pagamentostring
preference_id
Localização: bodyIdentificador da preferência de pagamento associada ao pedidostring
Solicitação
curl
curl -X PUT \
'https://api.mercadopago.com/merchant_orders/{id}' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-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
}'
Resposta
json
{
"id": 9999999999,
"status": "closed",
"external_reference": "default",
"preference_id": "Preference identification",
"payments": {},
"shipments": {},
"payouts": {},
"collector": {
"id": 999999999,
"email": "vendedor+329653108@adf12.com.br",
"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"
}
Erros
400bad_request
invalid_user_id
invalid_order_statethe action requested is not valid for the current merchant order state.
invalid_stringstring too long.
invalid_application_idinternal server error.
invalid_itemsonly the item quantity of an item can be modified.
user_not_alloweduser not allowed to operate.
invalid_payment_idinvalid payment identifier.
invalid_operation_typeinvalid operation type.
invalid_payerinvalid payer identifier.
invalid_shipment_idinvalid shipment identifier.
invalid_sponsor_idinvalid sponsor_id.
invalid_marketplaceinvalid marketplace.
unmarshall_errorcould not unmarshal request body into merchant order struct.
invalid_formatinvalid merchant order id.
invalid_urlinvalid URL. Isn't HTTP or HTTPS.
communication_errorError when calling...
401bad_request
invalid_tokenaccess denied.
invalid_caller_idinvalid caller_id