/merchant_orders

BASE URI https://api.mercadopago.com//merchant_orders

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.
product_id String Identificador del producto

Error Codes

CodeDescription
400 BAD_REQUEST
invalid_user_id invalid users involved.
invalid_order_state the action requested is not valid for the current merchnat 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.
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_id invalid preference_id.
invalid_expired the preference_id has expired.
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_url invalid URL. Isn't HTTP or HTTPS.
401 UNAUTHORIZED
invalid_token access denied.

La búsqueda no arrojó ningún resultado.

Verifica la la ortografía de los términos de búsqueda o prueba con otras palabras clave.