Merchant Orders API
Attributes
AttributeTypeDescription
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.
expired
Orden cancelada (cancelled: true) que no posee pagos aprobados ni pendientes (todos rechazados o devueltos).
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)
Campo deprecado, responderá una cadena vacía.
nickname
String(256)
Nickname del comprador.
collector
Object
Identificador del vendedor en Mercado Pago.
id
Integer
Identificador 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.
put
Requerido en PUT
category_id
String
Category del ítem.
currency_id
String(3)
Identificador de la moneda utilizada en el precio del ítem.
ARS
Peso argentino.
BRL
Real brasilero.
CLP
Peso chileno.
MXN
Peso mexicano.
COP
Peso colombiano.
PEN
Sol peruano.
UYU
Peso uruguayo.
description
String
Descripción del ítem.
picture_url
String
URL de imagen del ítem.
quantity
Integer
Cantidad de items.
put
Este es el único campo de ítem que puede ser modificado con un put put
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.
order_status
String
Estado actual de la orden según el estado de los pagos.
payment_required
Orden sin ningún pago o con todos los pagos "rejected" o "cancelled".
reverted
Orden con todos los pagos en "refunded" o "chargeback".
paid
Orden con la suma de todos los pagos "approved", "chargeback" o "in_mediation" cubre el monto total de la orden.
partially_reverted
Orden con al menos un pago en "refunded" o "chargeback".
partially_paid
Orden con al menos un pago en "approved" y no cubre el total de la orden.
payment_in_process
Orden con pagos "in_process", "pending" or "authorized".
undefined
Orden creada antes de la existencia del estado order_status.
expired
Orden cancelada (cancelled: true) que no posee pagos aprobados ni pendientes (todos rechazados o devueltos).