Gestiona ventas

Una orden es una solicitud que realiza un cliente para una publicación con intención de comprarlo conforme a una serie de condiciones que seleccionará en el flujo del proceso de compra online (checkout). Estas condiciones se detallan en la orden, la cual se replicará para las cuentas del comprador y el vendedor. En la orden encontrarás información sobre el producto para completar, como la posibilidad de reservar y/o descontar stock.

Contenidos

→Recibe una orden
→Cálculo del total_amount_with_shipping
→Búsqueda de órdenes
→Información de los productos en orders
→¿Cómo filtrar?
→¿Cómo ordenar?
→Órdenes recientes
→Órdenes de Mercado Shops
→Cómo consultar pedidos de Mercado Shops
→Órdenes Archivadas
→Órdenes Pendientes
→Estado de la orden
→Flujo de Mercado Pago obligatorio (sólo para países con MP)
→Flujo de devolución de dinero en cuenta por ventas canceladas
→¿Cómo tu app toma conocimiento de una compra?
→Recibir una notificación
→Pagos
→Escenario de pagos múltiples
→¿Cómo puedo saber si existen dos pagos?
→¿Cómo obtener información de un pago?
→¿Cómo obtener información del pago siendo vendedor?
→Cómo agregar una nota a una orden
→Visualiza notas de órdenes
→Cómo modificar una nota
→Elimina notas
→Bloquea ofertas
→¿Cómo bloqueo ofertas de un usuario específico?
→Consulta tu lista negra
→Elimina a un usuario de tu lista negra
→Referencias de Códigos de Error
→Referencias de código de respuesta HTTP


Recibe una orden

Una vez que se crea una nueva orden en el usuario, se puede consultar los detalles al realizar una solicitud al recurso de órdenes: Ejemplo:

curl -X GET -H 'x-format-new: true' https://api.mercadolibre.com/orders/$ORDER_ID?access_token=$ACCESS_TOKEN

Respuesta:

{
  "id": 768570754,
  "status": "paid",
  "status_detail": null,
  "date_created": "2013-05-27T10:01:50.000-04:00",
  "date_closed": "2013-05-27T10:04:07.000-04:00",
  "order_items": - [
  - {
    "item": - {
      "id": "MLB12345678",
      "title": "Samsung Galaxy",
      "variation_id": null,
      "variation_attributes": [
      ],
    },
    "quantity": 1,
    "unit_price": 499,
    "currency_id": "BRL",
  },
  ],
  "total_amount": 499,
  "currency_id": "BRL",
  "buyer": - {
  "id": "123456789",
  "nickname": "COMPRADORTESTE",
  "email": "b@b.com",
  "first_name": "Comprador de testes",
  "last_name": "da Silva",
  "billing_info": - {
    "doc_type": "CPF",
    "doc_number": "12345678910",
  },
  },
  "seller": - {
  "id": "123456789",
  "nickname": "VENDEDORTESTES",
  "email": "a@a.com",
  "first_name": "Vendedor de Testes",
  "last_name": "testes de documentacao",
  },
  "payments": - [
  - {
    "id": "596707837",
    "transaction_amount": 499,
    "currency_id": "BRL",
    "status": "approved",
    "date_created": null,
    "date_last_modified": null,
  },
  ],
  "feedback": - {
  "purchase": null,
  "sale": null,
  },
  "shipping": - {
  "id": 20676482441
  
  },
  "tags": - [
  "paid",
  "not_delivered",
  ],
}

Existen gran cantidad de atributos conforme a una orden. A continuación veremos una descripción de los campos más importantes.
id Identificador único de la orden.
date_created Fecha de creación de la orden
date_closed Fecha de confirmación de la orden. Se define cuando una orden cambia por primera vez al estado: confirmed / paid y se descuenta el stock del ítem.
expiration_date Fecha límite que tiene el usuario para calificar porque, luego de la misma, se vuelve visible el feedback, se emiten los pagos (si hubiese) y se crean los cargos.
status Estado de la orden. Ver los valores posibles.
status_detail Detalle del estado, en caso de cancelación de la orden.
code Código del estado.
description Descripción del estado.
comprador Información del comprador.
vendedor Información del vendedor.
order_items Publicaciones en la orden.
payments Pagos relacionados con la orden.
feedback Información de feedback relacionada con la orden.
shipping Configuración del envío para este orden.
total_amount Monto total de la orden.
currency_id ID de moneda.
tags Lista de los tags seleccionados por el vendedor, tales como entregado, pagado.

Nota:
Del mismo modo que ocurre cada vez que se actualiza la información de una orden, en caso de que descubramos que la compra fue fraudulenta, marcaremos la orden con el tag "fraud_risk_detected" y te enviaremos una notificación con el topic "orders" y el ID de dicha orden.
Para obtener información del envío, se debe realizar un llamado al recurso /shipments/shipping.id con el id obtenido en la orden. Para más información consulta nuestra guía de shipments.

Cálculo del total_amount_with_shipping

Con la respuesta que se obtiene en el llamado a GET /orders/:id con el header x-format-new: true y el llamado al recurso GET /shipments/:shipping_id se debe realizar el siguiente cálculo:

total_amount_with_shipping = total_amount + taxes.amount * + shipping_options.cost *

*En la misma moneda del ítem.

Importante:
En caso de que taxes.currency_id sea distinto a items.currency_id debemos obtener el ratio de conversión:

Llamada:

curl -X GET  https://api.mercadolibre.com/currency_conversions/search?from=$CURRENCY_ID&to=$CURRENCY_ID

Ejemplo:

curl -X GET  https://api.mercadolibre.com/currency_conversions/search?from=ARS&to=BRL

Respuesta:

{
  "ratio": 0.0704988
}


¿Qué sucederá con la venta según su envío?

Sin Mercado Envíos: El vendedor será notificado vía e-mail o telefónicamente.

  • En caso de que el producto ya haya sido entregado y exista una prueba de ello, el vendedor queda cubierto ante un contracargo. Eso significa que noscontaremos el dinero de la venta.
  • Si el producto todavía no se entregó, el vendedor deberá hacer el refund del dinero.
  • Para conocer cómo hacer un refund vía API consulta la documentación correspondiente.
  • Para más información te sugerimos leer la documentación de Requisitos del Programa de Protección al Vendedor.

Con Mercado Envíos: Si aún la etiqueta no ha sido impresa se cancelará la venta y se enviará una notificación al vendedor. Por otro lado, si el producto ya ha sido despachado Mercado Libre se comunicará con la empresa de envíos para que lo devuelva.


Búsqueda de órdenes

El recurso de búsqueda de órdenes te ayudará a buscar cada orden que pertenece a usuarios para quienes tienen un token válido.

curl -X GET https://api.mercadolibre.com/orders/search?buyer=buyer_id&access_token=$ACCESS_TOKEN
Importante:
A partir del 21 de noviembre, solo se guardan órdenes creadas por 12 meses y estarán disponibles aquellas órdenes que fueron canceladas manualmente (status manually_cancelled) y las que tengan un ítem eliminado si se utiliza la búsqueda como comprador (buyer). En caso que se realice la búsqueda por vendedor (seller) se continuará filtrando dichas órdenes.


Información de los productos en orders

Esta búsqueda muestra toda la información de los productos que están en el mismo pedido:

curl -X GET https://api.mercadolibre.com/orders/$ORDER_ID/product?access_token=$ACCESS_TOKEN

Respuesta:

{
	"attributes": [
    		{
        		"name": "IMEI",
        	"value": "111",
        		"id": 1
    	},
    		{
        		"name": "IMEI",
        	"value": "222",
        		"id": 2
    	},
    		{
        		"name": "entry_date",
        	"value": "01/01/2001",
        		"id": 3
    	}
	]
}


¿Cómo filtrar?

Para filtrar tus órdenes con status “paid” cuentas con los siguientes filtros:

item: ID o título 
tags: puede ser varios estados separados por ',' 
tags.not: puede ser varios estados separados por ','
q: es un campo genérico que permite buscar por:

  • id de la orden
  • id del item  
  • título del ítem
  • firts_name, last_name, email o nickname de la contraparte

order.status: puede ser varios estados separados por ','
order.date_last_updated.from
order.date_last_updated.to
order.date_created.from
order.date_created.to
order.date_closed.from
order.date_closed.to
mediations.status: puede ser varios estados separados por ','
feedback.status: puede ser varios estados separados por ','
feedback.sale.rating: puede ser varios estados separados por ','
feedback.sale.fulfilled
feedback.purchase.rating: puede ser varios estados separados por ','
feedback.purchase.fulfilled

Ejemplo:

curl  -X GET https://api.mercadolibre.com/orders/search?seller=seller_id&order.status=paid&access_token=$ACCESS_TOKEN

En el caso de querer filtrar tus órdenes por fecha deberás hacerlo de la siguiente manera:

curl  -X GET https://api.mercadolibre.com/orders/search?seller=$SELLER_ID&order.date_created.from=2015-07-01T00:00:00.000-00:00&order.date_created.to=2015-07-31T00:00:00.000-00:00&access_token=
Notas:
Para filtrar por fecha sólo se utiliza hasta la hora. Se descarta la información de los minutos, segundos y milisegundos.


¿Cómo ordenar?

En este caso deberás agregar “sort” con el ID disponible del orden que quieras aplicar, por ejemplo: “date_desc”

curl -X GET https://api.mercadolibre.com/orders/search?seller=$SELLER_ID&order.status=paid&sort=date_desc&access_token=$ACCESS_TOKEN
Notas:
Por defecto ya viene con una orden date_asc aplicada. La fecha por la que se ordena es:
- Sellers por date_closed.
- Buyers por date_created.


Órdenes recientes

Las órdenes recientes son las más nuevas generadas para un usuario. La respuesta incluirá órdenes en los que la fecha actual es anterior a la expiration_date y aún no han sido calificadas por ninguna de las partes. Búsqueda de las órdenes recientes de un vendedor:

https://api.mercadolibre.com/orders/search/recent?seller=$SELLER_ID&access_token=$ACCESS_TOKEN

Búsqueda de las órdenes recientes de un comprador:

curl -X GET https://api.mercadolibre.com/orders/search/recent?buyer=$BUYER_ID&access_token=$ACCESS_TOKEN


Órdenes de Mercado Shops

Las órdenes de Mercado Shops también se encuentran disponibles en la API de Mercado Libre.

Para identificar esas órdenes, debe utilizar el tag "mshops". 

Ejemplo de orden de Mercado Shops:

curl -X GET -H x-format-new: true https://api.mercadolibre.com/orders/$ORDER_ID?access_token=$ACCESS_TOKEN

{
    "id": 2063200914,
    "date_created": "2019-06-24T15:53:04.000-04:00",
    "date_closed": "2019-06-24T15:53:06.000-04:00",
    "last_updated": "2019-06-24T15:53:06.000-04:00",
    "manufacturing_ending_date": null,
    "feedback": {
        "sale": null,
        "purchase": null
    },
    "mediations": [],
    "comments": null,
    "pack_id": null,
    "pickup_id": null,
    "order_request": {
        "return": null,
        "change": null
    },
    "fulfilled": null,
    "total_amount": 25,
    "paid_amount": 31.9,
    "coupon": {
        "id": null,
        "amount": 0
    },
    "expiration_date": "2019-07-22T15:53:06.000-04:00",
    "order_items": [
        
            "item": {
                "id": "MLB1231068128",
                "title": "Teste Anúncio Me2 - Não Ofertar",
                "category_id": "MLB271107",
                "variation_id": null,
                "seller_custom_field": null,
                "variation_attributes": [],
                "warranty": null,
                "condition": "new",
                "seller_sku": null
            },
            "quantity": 1,
            "unit_price": 25,
            "full_unit_price": 25,
            "currency_id": "BRL",
            "manufacturing_days": null
        
    ],
    "currency_id": "BRL",
    "payments": [
        
            "id": 4898000077,
            "order_id": 2063200914,
            "payer_id": 419067349,
            "collector": {
                "id": 419059118
            },
            "card_id": 313381752,
            "site_id": "MLB",
            "reason": "Teste Anúncio Me2 - Não Ofertar",
            "payment_method_id": "master",
            "currency_id": "BRL",
            "installments": 1,
            "issuer_id": "24",
            "atm_transfer_reference": {
                "company_id": null,
                "transaction_id": "1234567"
            },
            "coupon_id": null,
            "activation_uri": null,
            "operation_type": "regular_payment",
            "payment_type": "credit_card",
            "available_actions": [
                "refund"
            ],
            "status": "approved",
            "status_code": null,
            "status_detail": "accredited",
            "transaction_amount": 25,
            "taxes_amount": 0,
            "shipping_cost": 6.9,
            "coupon_amount": 0,
            "overpaid_amount": 0,
            "total_paid_amount": 31.9,
            "installment_amount": 31.9,
            "deferred_period": null,
            "date_approved": "2019-06-24T15:53:05.000-04:00",
            "authorization_code": "1234567",
            "transaction_order_id": null,
            "date_created": "2019-06-24T15:53:05.000-04:00",
            "date_last_modified": "2019-06-24T15:53:05.000-04:00"
        
    ],
    "shipping": {
        "id": 28001747957
    },
    "status": "paid",
    "status_detail": null,
    "tags": [
        "mshops",
        "test_order",
        "not_delivered",
        "paid"
    ],
    "buyer": {
        "id": 419067349,
        "nickname": "TT763866",
        "email": "ttest.6hqmq6+2-ogiydmmzsgaydsnjx@mail.mercadolivre.com",
        "first_name": "Test",
        "last_name": "Test",
        "billing_info": {
            "doc_type": "CPF",
            "doc_number": "78525276200"
        
    },
    "seller": {
        "id": 419059118,
        "nickname": "TETE8288849",
        "email": "ttest.hpz2z6q+2-ogiydmmzsgaydsnjs@mail.mercadolivre.com",
        "phone": {
            "area_code": "01",
            "extension": "",
            "number": "1111-1111",
            "verified": false
        },
        "alternative_phone": {
            "area_code": "",
            "extension": "",
            "number": ""
        },
        "first_name": "Test",
        "last_name": "Test"
    },
    "taxes": {
        "amount": null,
        "currency_id": null
    
}

La estructura del Json es la misma que la de las órdenes de Mercado Libre. Los pedidos de Mercado Shops también pueden ser de carrito. Para esto, consulta la documentación Manejo de Órdenes de Carrito.


Cómo consultar pedidos de Mercado Shops

Para consultar los pedidos de Mercado Shops, basta con consultar con el tag mshops como el siguiente ejemplo:

curl -X GET https://api.mercadolibre.com/orders/search?seller=$SELLER_ID&tags=mshops&access_token=$ACCESS_TOKEN


Órdenes Archivadas

Si buscas una orden con expiration_date posterior a la fecha actual o que fue calificada por ambas partes, puedes utilizar el recurso de búsqueda en órdenes archivadas: Búsqueda de las órdenes archivadas de un vendedor:

curl -X GET https://api.mercadolibre.com/orders/search/archived?seller=$SELLER_ID&access_token=$ACCESS_TOKEN

Búsqueda de las órdenes archivadas de un comprador:

curl -X GET https://api.mercadolibre.com/orders/search/archived?buyer=$BUYER_ID&access_token=$ACCESS_TOKEN


Órdenes Pendientes

Esta búsqueda recuperará todas las órdenes en estado “pendiente” y omitirá las canceladas automáticamente. Si deseas ver las órdenes de un vendedor, envía el seller_id:

curl -X GET https://api.mercadolibre.com/orders/search/pending?seller=$SELLER_ID&access_token=$ACCESS_TOKEN

Para buscar por comprador, reemplaza los parámetros como se indica a continuación:

curl -X GET 
https://api.mercadolibre.com/orders/search/pending?buyer=$USER_ID&access_token=$ACCESS_TOKEN


Estado de la orden

Los estados de la orden son los siguientes:
confirmed Estado inicial de un orden; aún sin haber sido pagada.
payment_required Es necesario que se confirme el pago de la orden necesita para mostrar la información del usuario.
payment_in_process Existe un pago relacionado con la orden, pero aún no se acreditó.
partially_paid La orden tiene un pago asociado acreditado, pero no es suficiente.
paid La orden tiene un pago asociado acreditado.
cancelled Por alguna razón, la orden no se completó.*
invalid La orden fue invalidada porque provenía de un comprador malicioso.

Notas:
Una orden puede ser cancelada por los siguiente motivos:
- Se requería aprobación del pago para descontar el stock, pero en el tiempo de proceso de aprobación el ítem fue pausadoizado por falta de stock por lo tanto se devuelve el pago al comprador.
- Se requería el pago, pero después de cierto tiempo no se abonó, por eso se cancela automáticamente.
- Luego de efectuarse una transacción, por alguna razón el vendedor queda prohibido en el site.
- Si por alguna razón el vendedor califica como no concretada la operación, la orden toma el "status = confirmed". En caso de existir unaprobado este se devolverá automáticamente. Ten en cuenta, que una orden que no fue concretada por el vendedor por front se verá como "Cancelada" y por api quedara con "status: confirmed".


Flujo de Mercado Pago obligatorio (sólo para países con Mercado Pago)

¿Cómo saber si un site tiene Mercado Pago activo? Para obtener esa información deberás realizar la siguiente llamada:

curl https://api.mercadolibre.com/sites/MLA

Si obtienes "MLAMP" como respuesta dentro de los "payment_method_ids" podrás trabajar sin problemas con este flujo. Aclaración: MLAMP es el ID del método de pago Mercado Pago:

curl https://api.mercadolibre.com/payment_methods/MLAMP

Dentro de nuestra plataforma encontrarás orders que pueden entrar por el flujo obligatorio de Mercado Pago como único medio de pago y otras que no. Los escenarios que se presentan a continuación son en los que podrás encontrar esta opción de manera obligatoria:

  • Todas las órdenes de MLB.
  • Todas las órdenes de MLA y MLM por venta de productos con "condition": "new".
  • Publicaciones de Tiendas Oficiales en todos los países con Mercado Pago.
  • Categorías con Mercado Pago como única opción (Para más información dirigete a:Categorías con pago inmediato.
  • Usuario marcado automáticamente para que sus operaciones vayan por este flujo, con la marca “immediate_payment” en la API de user.
  • Vendedor "auto" marcado para que sus ventas vayan porflujo.

Ahora explicamos cómo es el funcionamiento general de las órdenes ya sea que ingresen por este flujo o no: 1) Las órdenes que entran por este flujo se crean en estado "payment_required". En ese momento tienen las siguientes características:

  • No son visibles para el seller.
  • No se descuenta el stock de item.
  • No tienen establecido el campo date_closed.
  • No tienen datos de la contraparte.
  • Se envía sólo la notificación del topic "created_orders".

Cuando el pago se acredita por el monto total de la venta, la orden pasa del estado "payment_required" a “paid”. En ese momento:

  • Se hacen visibles para el seller.
  • Se descuenta el stock de item.
  • Se establece el campo date_closed.
  • Se agregan los datos de la contraparte.
  • Comienzan a enviarse además las notificaciones del topic "orders".

Las órdenes que NO entran por este flujo se crean en estado “confirmed”. Desde ese momento:

  • Son visibles para el seller.
  • Se descuenta el stock de item.
  • Se establece el campo date_closed.
  • Tiene los datos de la contraparte.
  • Comienzan a enviarse además las notificaciones del topic "orders"/”created_orders”.

En caso de que se termine efectuando un pago a través de Mercado Pago y es acreditado por el monto total de la venta, la orden pasa del estado "confirmed" a "paid".
Aclaración: En ambos casos, si durante el flujo de pago el comprador elige Mercado Envíos (ME2, sólo en países dónde está activo este servicio), el envío tendrá disponible para imprimir la etiqueta una vez que haya pasado a “paid” la order. Más info.


Flujo de devolución de dinero en cuenta por ventas canceladas

Importante:
Solo está disponible para vendedores de México y próximamente, para aquellos de Argentina y Brasil.

Ante cancelaciones por los vendedores, los compradores con buena reputación y que realicen pagos con tarjeta de crédito o débito recibirán automáticamente la devolución con dinero en cuenta de Mercado Pago.
De esta manera, la orden de compra queda en estado diferente respecto de los demás flujos. Los cambios serán:

  • status = paid
  • Nuevo tag: unfulfilled
Nota:
La orden jamás tendrá el status cancelled ya que mediante la devolución con dinero en cuenta genera que el pago debe concretarse. En el pago de la orden encontrarás el tag refund_account_money.


¿Cómo tu app toma conocimiento de una compra?

La creación de una orden es un evento que se produce del lado de Mercado Libre, por eso deberás suscribirte a nuestro feed de orders para tomar conocimiento en tiempo real cuando ese evento ocurre. Dirígete a nuestro Administrador de Aplicaciones y edita las Configuraciones de Notificaciones de tu aplicación. Para más información sobre crear y configurar una nueva aplicación, por favor consulta este link. Debes seleccionar un Callback URL: configura el URL público del dominio donde deseas recibir todas las notificaciones de Mercado Libre. Por ejemplo: "https://backend.soleorigami.com/notification".
topicsconmensajeria

Esta configuración te permite interactuar con las notificaciones de Mercado Libre. Todos los eventos (como pagos y envío) relacionados con un orden serán notificados a tu callback URL.


Recibir una notificación

Mercado Libre te enviará notificaciones a través de un mensaje POST con información en el cuerpo de publicación. El atributo más importante del mensaje es el user_id, que está relacionado con la notificación, y el segundo en importancia es el recurso. El recurso es el elemento que fue actualizado o creado.

{
  "user_id": 1234,
  "resource": "/orders/731867397",
  "topic": "orders",
  "received": "2011-10-19T16:38:34.425Z",
  "application_id" : 14529
  "sent" : "2011-10-19T16:40:34.425Z",
  "attempts" : 0
}

Después de recibir la notificación, debes enviar un acuse de recibo [acknowledgment] (ACK 200) a Mercado Libre para dejar de recibirla.


Pagos

Mercado Pago es la plataforma de pagos de Mercado Libre. Si deseas integrar una solución de pagos en tu plataforma, debes consultar el sitio de desarrolladores de Mercado Pago.


Escenario de pagos múltiples

En algunos casos, cuando se rechaza el pago por llegar al límite de la tarjeta de crédito, permitimos a los usuarios agregar otro pago con una segunda tarjeta de crédito.


¿Cómo puedo saber si existen dos pagos?

Cuando realizas una solicitud GET a la API de órdenes, verás que dentro del conjunto de pagos habrá dos ID con los detalles de cada pago. Ejemplo:

curl -X GET https://api.mercadolibre.com/orders/893431118?access_token=&ACCESS_TOKEN

Respuesta

{
  "buyer": {
      "alternative_phone": {
          "area_code": null,
          "extension": null,
          "number": ""
      },
      "billing_info": {
          "doc_number": "67045427794",
          "doc_type": "CPF"
      },
      "email": "test_user_21963158@testuser.com",
      "first_name": "Test",
      "id": 160903317,
      "last_name": "Test",
      "nickname": "TETE2022123",
  },
  "coupon": {
      "amount": 0,
      "id": null
    },
  "currency_id": "BRL",
  "date_closed": null,
  "date_created": "2014-10-26T22:46:18.000-04:00",
  "feedback": {
      "purchase": null,
      "sale": null
  },
  "id": 893431118,
  "last_updated": "2014-10-26T22:50:10.000-04:00",
    "mediations": [],
  "order_items": [
      {
          "currency_id": "BRL",
          "item": {
              "id": "MLB600034093",
              "title": "Item De Testeo, Por Favor No Ofertar --kc:off",
              "variation_attributes": [],
              "variation_id": null
          },
          "quantity": 1,
          "unit_price": 591
      }
  ],
  "paid_amount": 591,
  "payments": [
      {
          "activation_uri": null,
          "atm_transfer_reference": {
              "company_id": null,
                "transaction_id": null
          },
            "available_actions": [],
          "card_id": null,
          "collector": {
              "id": 169648308
          },
          "coupon_amount": 0,
          "coupon_id": null,
          "currency_id": "BRL",
          "date_created": "2014-10-26T22:48:46.000-04:00",
            "date_last_modified": "2014-10-27T00:51:53.000-04:00",
          "id": 885920310,
          "installments": 1,
          "issuer_id": "25",
          "operation_type": "regular_payment",
          "order_id": 893431118,
          "overpaid_amount": 0,
          "payer_id": 160903317,
            "payment_method_id": "visa",
          "payment_type": "credit_card",
          "reason": "Item De Testeo, Por Favor No Ofertar --kc:off",
          "shipping_cost": 0,
          "site_id": "MLB",
          "status": "approved",
          "status_code": null,
          "status_detail": "accredited",
            "total_paid_amount": 296,
            "transaction_amount": 296
      },
      {
          "activation_uri": null,
            "atm_transfer_reference": {
              "company_id": null,
                "transaction_id": null
          },
            "available_actions": [],
          "card_id": null,
          "collector": {
              "id": 169648308
          },
          "coupon_amount": 0,
          "coupon_id": null,
          "currency_id": "BRL",
          "date_created": "2014-10-26T22:50:10.000-04:00",
            "date_last_modified": "2014-10-26T22:50:21.000-04:00",
          "id": 885920410,
          "installments": 3,
          "issuer_id": "25",
          "operation_type": "regular_payment",
          "order_id": 893431118,
          "overpaid_amount": 0,
          "payer_id": 160903317,
            "payment_method_id": "visa",
          "payment_type": "credit_card",
          "reason": "Item De Testeo, Por Favor No Ofertar --kc:off",
          "shipping_cost": 0,
          "site_id": "MLB",
          "status": "approved",
          "status_code": null,
          "status_detail": "accredited",
            "total_paid_amount": 315.62,
            "transaction_amount": 295
      }
  ],
  "seller": {
      "alternative_phone": {
          "area_code": null,
          "extension": null,
          "number": ""
      },
      "email": "test_user_70385259@testuser.com",
      "first_name": "Test",
      "id": 169648308,
      "last_name": "Test",
      "nickname": "TETE6072468",
      "phone": {
          "area_code": "01",
          "extension": null,
          "number": "1111-1111"
      }
  },
  "shipping": {
      "status": "to_be_agreed"
  },
  "status": "paid",
  "status_detail": null,
  "tags": [
      "not_delivered",
      "paid"
  ],
  "total_amount": 591,

}


¿Cómo obtener información de un pago?

Para obtener información del pago de un comprador utilizando el token deberás recurrir al recurso “payments”.
Ejemplo:

https://api.mercadolibre.com/payments?access_token=


¿Cómo obtener información del pago siendo vendedor?

Para obtener información del pago de una orden, se deberá recurrir al recurso payments de la API de Mercado Pago. Dependiendo del token, se reconocerá si quien consulta es el buyer o el seller, y se devolverá la información que corresponda.
Llamado:

curl -X GET https://api.mercadopago.com/v1/payments/payment_id?access_token=$ACCESS_TOKEN

Respuesta: Ejemplo con token de vendedor

curl -X GET https://api.mercadopago.com/v1/payments/3506756222?access_token
{
  "counter_currency": null,
  "acquirer_reconciliation": [
  ],
  "statement_descriptor": "MERCADOPAGO",
  "captured": true,
  "fee_details": [
    {
      "amount": 487.2,
      "fee_payer": "payer",
      "type": "financing_fee"
    }
  ],
  "acquirer": null,
  "date_last_updated": "2018-03-05T10:06:55.000-04:00",
  "date_created": "2018-03-05T10:06:54.000-04:00",
  "id": 3506756222,
  "merchant_account_id": null,
  "issuer_id": "157",
  "date_of_expiration": null,
  "external_reference": "1653027692",
  "order": {
    "id": "1653027692",
    "type": "mercadolibre"
  },
  "transaction_amount": 3500,
  "description": "Maquina Industrial Recta Marca ",
  "card": {
    "id": null,
    "first_six_digits": "371772",
    "expiration_month": 10,
    "cardholder": {
      "identification": {
        "number": null,
        "type": null
      },
      "name": "JOAN C GONZALEZ GUZMAN"
    },
    "date_last_updated": "2018-03-05T10:06:54.000-04:00",
    "date_created": "2018-03-05T10:06:54.000-04:00",
    "expiration_year": 2019,
    "last_four_digits": "1001"
  },
  "transaction_details": {
    "total_paid_amount": 3987.2,
    "acquirer_reference": null,
    "payment_method_reference_id": null,
    "net_received_amount": 3500,
    "financial_institution": null,
    "payable_deferral_period": null,
    "installment_amount": 443.02,
    "external_resource_url": null,
    "overpaid_amount": 0
  },
  "coupon_amount": 0,
  "merchant_number": null,
  "call_for_authorize_id": null,
  "metadata": {
  },
  "currency_id": "MXN",
  "money_release_schema": null,
  "collector_id": 277582551,
  "status": "approved",
  "sponsor_id": null,
  "deduction_schema": null,
  "payment_method_id": "amex",
  "additional_info": {
    "items": [
      {
        "id": "MLM610028711",
        "title": "Maquina Industrial Recta Marca",
        "picture_url": null,
        "description": null,
        "category_id": "MLM184696",
        "quantity": "1",
        "unit_price": "3500"
      }
    ]
  },
  "processing_mode": "aggregator",
  "status_detail": "accredited",
  "binary_mode": false,
  "operation_type": "regular_payment",
  "installments": 9,
  "money_release_date": "2018-03-26T10:06:55.000-04:00",
  "payer": {
    "id": "53745235",
    "first_name": "Joan Carlos",
    "phone": {
      "extension": null,
      "area_code": null,
      "number": "5558800201"
    },
    "email": null,
    "identification": {
      "number": "83092109600",
      "type": "IFE"
    },
    "last_name": "Gonzalez Guzman",
    "entity_type": null,
    "type": "registered"
  },
  "notification_url": null,
  "transaction_amount_refunded": 0,
  "refunds": [
  ],
  "date_approved": "2018-03-05T10:06:55.000-04:00",
  "authorization_code": "211118",
  "payment_type_id": "credit_card",
  "live_mode": true
}


Ejemplo con token de comprador

GET https://api.mercadopago.com/v1/payments/3506756222?access_token
{
  "counter_currency": null,
  "acquirer_reconciliation": [
  ],
  "statement_descriptor": "MERCADOPAGO",
  "captured": true,
  "fee_details": [
    {
      "amount": 487.2,
      "fee_payer": "payer",
      "type": "financing_fee"
    }
  ],
  "acquirer": null,
  "date_last_updated": "2018-03-05T10:06:55.000-04:00",
  "date_created": "2018-03-05T10:06:54.000-04:00",
  "id": 3506756222,
  "merchant_account_id": null,
  "payer_id": 53745235,
  "collector": {
    "id": 277582551,
    "first_name": "Belem",
    "phone": {
      "extension": null,
      "area_code": null,
      "number": "5547588284"
    },
    "email": null,
    "identification": {
      "number": null,
      "type": null
    },
    "last_name": "Jimenez"
  },
  "issuer_id": "157",
  "date_of_expiration": null,
  "external_reference": "1653027692",
  "order": {
    "id": "1653027692",
    "type": "mercadolibre"
  },
  "transaction_amount": 3500,
  "description": "Maquina Industrial Recta Marca ",
  "card": {
    "id": null,
    "first_six_digits": "371772",
    "expiration_month": 10,
    "cardholder": {
      "identification": {
        "number": null,
        "type": null
      },
      "name": "JOAN C GONZALEZ GUZMAN"
    },
    "date_last_updated": "2018-03-05T10:06:54.000-04:00",
    "date_created": "2018-03-05T10:06:54.000-04:00",
    "expiration_year": 2019,
    "last_four_digits": "1001"
  },
  "transaction_details": {
    "total_paid_amount": 3987.2,
    "acquirer_reference": null,
    "payment_method_reference_id": null,
    "net_received_amount": 3500,
    "financial_institution": null,
    "payable_deferral_period": null,
    "installment_amount": 443.02,
    "external_resource_url": null,
    "overpaid_amount": 0
  },
  "coupon_amount": 0,
  "merchant_number": null,
  "call_for_authorize_id": null,
  "metadata": {
  },
  "currency_id": "MXN",
  "money_release_schema": null,
  "status": "approved",
  "sponsor_id": null,
  "deduction_schema": null,
  "payment_method_id": "amex",
  "additional_info": {
    "items": [
      {
        "id": "MLM610028711",
        "title": "Maquina Industrial Recta Marca",
        "picture_url": null,
        "description": null,
        "category_id": "MLM184696",
        "quantity": "1",
        "unit_price": "3500"
      }
    ]
  },
  "processing_mode": "aggregator",
  "status_detail": "accredited",
  "binary_mode": false,
  "operation_type": "regular_payment",
  "installments": 9,
  "differential_pricing_id": null,
  "money_release_date": "2018-03-26T10:06:55.000-04:00",
  "notification_url": null,
  "transaction_amount_refunded": 0,
  "refunds": [
  ],
  "date_approved": "2018-03-05T10:06:55.000-04:00",
  "authorization_code": "211118",
  "payment_type_id": "credit_card",
  "live_mode": true
}


Avanzado

Notas de órdenes

Una nota es una anotación que los vendedores pueden agregar a las órdenes. Las notas pueden tener hasta 300 caracteres cada una y, una vez que publicas una nota, puedes modificarla o eliminarla.


Cómo agregar una nota a una orden

curl -X POST -H "Content-Type: application/json" -d '{  	
   	"note": "test",
}' https://api.mercadolibre.com/orders/{order_Id}/notes?access_token=$ACCESS_TOKEN


Visualiza notas de órdenes

curl -X GET https://api.mercadolibre.com/orders/{order_Id}/notes?access_token=$ACCESS_TOKEN


Cómo modificar una nota

curl -X PUT -H "Content-Type: application/json" -d '{
   	"note": "test2",
}' https://api.mercadolibre.com/orders/$ORDER_ID/notes/$NOTE_ID?access_token=$ACCESS_TOKEN


Elimina notas

curl -X DELETE https://api.mercadolibre.com/orders/$ORDER_ID/notes/$NOTE_ID?access_token=$ACCESS_TOKEN


Bloquea ofertas

Aunque contamos con una prestación y flujos de prevención de fraude para mantener la seguridad de los compradores y vendedores, en algunas ocasiones puedes encontrar usuarios que, por algún motivo ofertan en las publicaciones. Estos casos pueden ser enviados a la lista negra para evitarles la posibilidad de ofertar.


¿Cómo bloqueo ofertas de un usuario específico?

Realiza una solicitud POST con el cust_id del usuario que deseas bloquear en el JSON y el tuyo en el url, como muestra el siguiente ejemplo:

curl -X POST -H "Content-Type: application/json" -d
{ user_id: {cust_id} }
https://api.mercadolibre.com/users/$CUST_ID/order_blacklist?access_token=$ACCESS_TOKEN


Consulta tu lista negra

Si deseas saber cuáles son los usuarios de tu lista negra, realiza una solicitud GET a la API con tu cust_id en el url:

curl -X GET https://api.mercadolibre.com/users/$CUST_ID/order_blacklist?access_token=$ACCESS_TOKEN


Elimina a un usuario de tu lista negra

Si ya no deseas bloquear a un usuario para que realice ofertas, puedes eliminarlo de tu lista negra al realizar una solicitud DELETE a la API con tu cust_id y el cust_id del usuario.

curl -X DELETE https://api.mercadolibre.com/users/{your_cust_id}/order_blacklist/{cust_id}


Referencias de Códigos de Error

Error_code Mensaje de error Descripción Posible solución
order_not_found orden no encontrada. $order_id incorrecto. No se puede encontrar la orden; consulta si el order_id es correcto.
empty_order_id El ID de la orden no puede estar vacío. $order_id es nulo. El parámetro order_id no puede ser nulo; consulta el URL utilizado.
invalid_order_id ID de la orden inválido. $order_id incorrecto. El parámetro order_id debe ser un número entero. (Para buscar tus órdenes consulta este tema).
not_identified_user Falta de Token. No existe un Token. Se deberá enviar un Token.
not_owned_order El usuario no tiene acceso al orden. $seller o $buyer incorrectos. Para ver un orden, tu access_token debe ser generado desde el vendedor o el comprador.
caller.id.invalid El caller.id no coincide con el comprador ni el vendedor. $seller o $buyer incorrectos. Para ver un orden, debes utilizar un ID del vendedor o del comprador.
feedback_not_found El feedback no existe. Error de respuesta. Consulta si existe feedback para dar una respuesta.
invalid_fulfilled El parámetro ‘completado’ debe ser verdadero o falso. Error al dar feedback. Consulta el parámetro $fulfilled; debe ser booleano (elimina las comillas) y consulta si el parámetro $reason no es nulo en caso de $fulfilled: falso.
reply_time_expired El tiempo de respuesta expiró. Existe un período de 14 días para responder el feedback. Error al dar respuesta sobre el feedback. La respuesta se puede enviar en los 14 días posteriores a la fecha del feedback.
reply_already_exists Ya existe respuesta para el feedback. Error al dar respuesta sobre el feedback. El feedback soporta una sola respuesta.

Referencias de código de respuesta HTTP

Orders podrá devolver el código http 206 cuando no se haya podido obtener algún dato. Ten en cuenta que en la mayoría de los casos la información que recibas será suficiente para que puedas seguir trabajando.
En el header de respuesta X-Content-Missing tendrás el nombre de los campos sin información, que pueden ser "buyer", "feedback", "mediations", "seller" y/o "shipping".


Llamada:

curl -X GET -H 'x-format-new: true' https://api.mercadolibre.com/orders/$ORDER_ID?access_token=$ACCESS_TOKEN

Respuesta:
< HTTP/1.1 206 Partial Content> X-Content-Missing: buyer, feedback

{
  "id": 768570754,
  "status": "paid",
  "status_detail": null,
  "date_created": "2013-05-27T10:01:50.000-04:00",
  "date_closed": "2013-05-27T10:04:07.000-04:00",
  "order_items": - [
	- {
  	"item": - {
    	"id": "MLB12345678",
  	  "title": "Samsung Galaxy",
    	"variation_id": null,
    	"variation_attributes": [
    	],
  	},
  	"quantity": 1,
  	"unit_price": 499,
  	"currency_id": "BRL",
	},
  ],
  "total_amount": 499,
  "currency_id": "BRL",
  "buyer": - { },
  },
  "seller": - {
	"id": "123456789",
	"nickname": "VENDEDORTESTES",
	"email": "a@a.com",
	"phone": - {
  	"area_code": null,
  	"number": "11 12345678",
  	"extension": "11",
	},
	"first_name": "Vendedor de Testes",
	"last_name": "testes de documentacao",
  },
  "payments": - [
	- {
  	"id": "596707837",
  	"transaction_amount": 499,
  	"currency_id": "BRL",
  	"status": "approved",
  	"date_created": null,
  	"date_last_modified": null,
	},
  ],
  "feedback": - { },
  "shipping": - {
	"id": 20676482441
	
  },
  "tags": - [
	"paid",
	"not_delivered",
  ],
}


Siguiente: API de mensajería.