Actualizar una orden - Órdenes - Mercado Pago Developers
Developers
Referencia de API
Soporte
Ingresar

    Introducción

    LISTA DE API

    Preferencias

    Crear una preferencia

    POST

    Buscar preferencias

    GET

    Obtener una preferencia

    GET

    Actualizar una preferencia

    PUT

    Tipos de documento

    Obtener tipos de documentos

    GET

    Medios de pago

    Obtener los medios de pago

    GET

    Pagos

    Crear un pago

    POST

    Buscar pagos

    GET

    Obtener un pago

    GET

    Actualizar un pago

    PUT

    Contracargos

    Obtener un contracargo

    GET

    Clientes

    Crear un cliente

    POST

    Buscar clientes

    GET

    Obtener un cliente

    GET

    Actualizar un cliente

    PUT

    Tarjetas

    Guardar una tarjeta

    POST

    Obtener tarjetas de un cliente

    GET

    Obtener una tarjeta

    GET

    Actualizar una tarjeta

    PUT

    Eliminar una tarjeta

    DELETE

    Sucursales

    Obtener una Sucursal

    GET

    Crear una Sucursal

    POST

    Buscar sucursales

    GET

    Actualizar una Sucursal

    PUT

    Eliminar una Sucursal

    DELETE

    Cajas

    Crear una Caja

    POST

    Buscar cajas

    GET

    Obtener una Caja

    GET

    Actualizar una Caja

    PUT

    Eliminar una Caja

    DELETE

    Órdenes presenciales

    Crear una orden

    POST

    Eliminar una orden

    DELETE

    Órdenes presenciales v2

    Crear una orden

    PUT

    Obtener una orden

    GET

    Eliminar una orden

    DELETE

    Órdenes

    Crear una orden

    POST

    Buscar órdenes

    GET

    Obtener una orden

    GET

    Actualizar una orden

    PUT

    Preferencia de Subscripción

    Crear una suscripción

    POST

Actualizar una orden

PUT

/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.
Productos que lo utilizan:
Checkout Pro
Marketplace
Código QR
Parámetros para la solicitud
id

REQUERIDO

number
Localización: pathOrder identifier
additional_info
string
Localización: bodyInformación adicional
application_id
string
Localización: bodyIdentificador de aplicación
external_reference
string
Localización: bodyReferencia que puedes sincronizar con tu sistema de pagos
Parámetros de respuesta
id
number
Localización: bodyid
status
string
Localización: bodyMuestra el estado actual de la orden
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
string
Localización: bodyexternal_reference
preference_id
string
Localización: bodypreference_id
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_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
¿Te resultó útil esta información?

Copyright © 1999-2021 MercadoLibre Perú S.R.L.

Términos y condicionesCómo cuidamos tu privacidad
Partners Mercado Pago

Al navegar en este sitio aceptas las cookies que utilizamos para mejorar tu experiencia. Más información.