Actualizar una orden/merchant_orders/{id}Renueva los datos de un pago. Indica el ID de la orden y envía los parámetros con la información que quieras actualizar.
PUT
Parámetros para la solicitud
idnumber
Localización: pathOrder identifierREQUERIDO
additional_info
Localización: bodyInformación adicionalstring
application_id
Localización: bodyIdentificador de aplicaciónstring
external_reference
Localización: bodyReferencia que puedes sincronizar con tu sistema de pagosstring
Parámetros de respuesta
id
Localización: bodyidnumber
status
Localización: bodyMuestra el estado actual de la ordenstring
opened: Orden sin pagos.
closed: Orden con pagos que cubren el monto total.
expired: Orden cancelada que no posee pagos aprobados ni pendientes (todos rechazados o devueltos).
external_reference
Localización: bodyexternal_referencestring
preference_id
Localización: bodypreference_idstring
Solicitud
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
}'
Respuesta
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"
}
Errores
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
¿Te resultó útil esta información?