Atualizar ordem - Pedidos comerciais - Mercado Pago Developers
Atualizar pedido

PUT

/merchant_orders/{id}
Atualizar os dados de um pagamento. Indique o ID da ordem e envie as informações que você deseja atualizar.
Parâmetros de requisição
id

OBRIGATÓRIO

number
Localização: pathIdentificador único do pedido gerado pelo Mercado Pago
additional_info
string
Localização: bodyInformações adicionais
application_id
string
Localização: bodyId do aplicativo
external_reference
string
Localização: bodyIdentificador único enviado pelo vendedor para relacionar o order_id gerado pelo Mercado Pago ao ID do seu sistema de pagamento
Parâmetros de resposta
id
number
Localização: bodyIdentificador único do pedido gerado pelo Mercado Pago
status
string
Localização: bodyExibe o estado atual da ordem
opened: Order without payments.
closed: Order with payments covering total amount.
expired: Pedido cancelado que não possui pagamentos aprovados ou pendentes (todos rejeitados ou devolvidos).
external_reference
string
Localização: bodyIdentificador único enviado pelo vendedor para relacionar o order_id gerado pelo Mercado Pago ao ID do seu sistema de pagamento
preference_id
string
Localização: bodyIdentificador da preferência de pagamento associada ao pedido
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_idinvalid users involved.
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