/merchant_orders/:id
BASE URI https://api.mercadopago.com//merchant_orders/{id}
Request Params
ParameterTypeDescription
id
Integer
Identificador de orden.
preference_id
String(UUID)
Identificador de la preferencia de pago asociado a la orden.
date_created
Date(ISO_8601)
Fecha de creación de la orden.
last_updated
Date(ISO_8601)
Fecha de última actulización de la orden.
application_id
String
Identificador de aplicación.
status
String
Muestra el estado actual de la orden.
opened
Orden sin pagos.
closed
Orden con pagos que cubren el monto total.
site_id
String
Identificador de país al que pertenece la orden.
payer
Object
Información del comprador.
id
Integer
Identificador del comprador.
email
String(256)
E-mail del comprador.
nickname
String(256)
Nickname del comprador.
collector
Object
Identificador del vendedor en Mercado Pago.
id
Integer
Identificador del collector.
email
String(256)
E-mail del collector.
nickname
String(256)
Nickname del collector.
sponsor_id
Integer
Identificador del sponsor en Mercado Pago.
payments
Array(Object)
Información de los pagos.
id
Integer
Identificador del pago.
transaction_amount
Float
Costo del producto.
total_paid_amount
Float
Monto total pagado por el comprador.
shipping_cost
Float
Costo de envío.
currency_id
String(3)
Identificador de la moneda utilizada en el pago.
ARS
Peso argentino.
BRL
Real brasilero.
CLP
Peso chileno.
MXN
Peso mexicano.
COP
Peso colombiano.
PEN
Sol peruano.
UYU
Peso uruguayo.
status
String
Estado del pago.
pending
El usuario no completó el proceso de pago todavía.
approved
El pago fue aprobado y acreditado.
authorized
El pago fue autorizado pero no capturado todavía.
in_process
El pago está en revisión.
in_mediation
El usuario inició una disputa.
rejected
El pago fue rechazado. El usuario podría reintentar el pago.
cancelled
El pago fue cancelado por una de las partes o el pago expiró.
refunded
El pago fue devuelto al usuario.
charged_back
Se ha realizado un contracargo en la tarjeta de crédito del comprador.
status_detail
String
Brinda más información del estado del pago o de la causa de rechazo.
operation_type
String
data_type de la operación.
regular_payment
Tipificación por defecto de una compra pagada por Mercado Pago.
payment_addition
Agregado de dinero a un pago ya realizado en Mercado Pago.
money_transfer
Transferencia de fondos entre usuarios.
recurring_payment
Pago recurrente automático por una suscripción de un usuario activo.
account_fund
Ingreso de fondos en la cuenta del usuario.
cellphone_recharge
Recarga de la cuenta telefónica de un usuario.
pos_payment
Pago realizado en un dispositivo POS.
date_approved
Date(ISO_8601)
Fecha de aprobación del pago
date_created
Date(ISO_8601)
Fecha de creación del pago.
last_modified
Date(ISO_8601)
Fecha de última actualización del pago.
amount_refunded
Float
Monto reembolsado en este pago.
paid_amount
Float
Monto pagado en la orden.
refunded_amount
Float
Monto reembolsado en la orden.
shipping_cost
Float
Costo de envío.
cancelled
Boolean
Indica si la orden está expirada o no.
items
Array(Object)
Información de los ítems.
id
String
Identificador del ítem.
category_id
String
Category del ítem.
currency_id
String(3)
Identificador de la moneda utilizada en el precio del ítem.
description
String
Descripción del ítem.
picture_url
String
URL de imagen del ítem.
quantity
Integer
Monto total pagado por el comprador.
unit_price
Float
Precio unitario del ítem.
title
String
Título del ítem.
shipments
Array(Object)
Información de los envíos.
id
Integer
Identificador del envío.
shipment_type
String
Tipo de envío.
shipping_mode
String
Modo de envío.
picking_type
String
Tipo de retiro de envío.
status
String
Tipo de retiro de envío.
substatus
String
Tipo de retiro de envío.
items
Array(Object)
Ítems a enviar.
date_created
Date(ISO_8601)
Fecha de creación del envío.
last_modified
Date(ISO_8601)
Fecha de última actualización del envío.
date_first_printed
Date(ISO_8601)
Primera fecha de impresión del envío.
service_id
String
Identificador de servicio del envío.
sender_id
Integer
Identificador del emisor.
receiver_id
Integer
Identificador del receptor.
receiver_address
Object
Dirección de envío.
id
Integer
Identifier of receiver address.
address_line
String
Street name and number of receiver address.
apartment
String(256)
Apartmento.
city
Object
Information about receiver address city.
id
String
City Identifier.
name
String
City name.
country
Object
Inforamtion about receiver address country.
id
String
Country identifier.
name
String
Country name.
state
Object
Information about receiver address state.
id
String
State identifier.
name
String
State name.
comment
String
Comment about receiver address.
contact
String
Contact information.
zip_code
String(256)
Código postal.
street_name
String(256)
Calle.
street_number
String(256)
Número.
floor
String(256)
Piso.
phone
String(256)
Receiver address phone.
latitude
String(256)
Receiver address latitude.
longitude
String(256)
Receiver address longitude.
shipping_option
Object
Shipping options.
cost
Float
Net cost absorbed by the receiver.
currency_id
String(3)
Currency identifier.
ARS
Peso argentino.
BRL
Real brasilero.
CLP
Peso chileno.
MXN
Peso mexicano.
COP
Peso colombiano.
PEN
Sol peruano.
UYU
Peso uruguayo.
estimated_delivery
Object
Estimated delivery time information.
date
Date(ISO_8601)
Estimated delivery date.
time_from
String
Estimated lower delivery time.
time_to
String
Estimated upper delivery time.
id
Integer
Shipping option identifier.
list_cost
Float
Net cost of the shipping.
name
String
Option name.
shipping_method_id
Integer
Shipping method identifier.
speed
Object
Shipping time information.
handling
Integer
Handling time.
shipping
Integer
Shipping time.
notification_url
String(500)
URL en la que te gustaría recibir una notificación del estado del pago.
additional_info
String(600)
Información adicional del pago.
external_reference
String(256)
Referencia que puedes sincronizar con tu sistema de pagos.
marketplace
String(256)
Origen del pago. Valor predeterminado: 'NONE'
total_amount
Float
Costo total de la orden.
Error Codes
CodeDescription
400 BAD_REQUEST
invalid_user_id
invalid users involved.
invalid_order_state
invalid_string
string too long.
invalid_application_id
internal server error.
invalid_items
should specify at least one item.
invalid_items
title cannot be null for the given item.
invalid_items
quantity cannot be null for the given item.
invalid_items
invalid item quantity.
invalid_items
unit_price cannot be null for the given item.
invalid_items
currency_id cannot be null for the given item.
invalid_items
cannot operate with this currency code.
invalid_items
invalid unit_price.
invalid_items
some item of the order does not exist.
invalid_items
only the item quantity of an item can be modified.
user_not_allowed
user not allowed to operate.
invalid_payment_id
invalid payment identifier.
invalid_operation_type
invalid operation type.
invalid_payer
invalid payer identifier.
invalid_shipment_id
invalid shipment identifier.
invalid_sponsor_id
invalid sponsor_id.
invalid_marketplace
invalid marketplace.
unmarshall_error
could not unmarshal request body into merchant order struct.
invalid_format
invalid merchant order id.
invalid_url
invalid URL. Isn't HTTP or HTTPS.
401 UNAUTHORIZED
invalid_token
access denied.