Last update 28/12/2022

Orders

This examples will help you manage orders.

Resource Description Example
/marketplace/orders/search Search all orders from a seller. GET
Go back X

Search the orders by seller

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/orders/search
 

Response

{
  "query": "",
  "results": [{
    "id": 2315686468,
    "buyer": {
      "id": 441782523
    },
    "config": {
      "items": [{
        "id": "MLM755638064"
      }]
    },
    "orders": [{
      "id": 2315686468,
      "items": null,
      "feedback": {
        "purchase": null,
        "sale": null
      },
      "payments": [{
        "id": 5882999015
      }],
      "mediations": [],
      "seller": {
        "id": 523132944
      }
    }],
    "shipment": {
      "id": 28242306889,
      "payments": []
    }
  }],
  "sort": {
    "id": "date_asc",
    "name": "Date ascending"
  },
  "available_sorts": [{
    "id": "date_desc",
    "name": "Date descending"
  }],
  "filters": [],
  "paging": {
    "total": 1,
    "limit": 50,
    "scroll_id": "YXNzb3J0ZWQtbWVkaXVtLXpldGEtdGVtcA==:ZHMtYXNzb3J0ZWQtbWVkaXVtLXpldGEtMDE=:DXF1ZXJ5QW5kRmV0Y2gBAAAAAHxnEgwWZG1TRzNfNklSaE9VTUZYeGhfc1dFdw=="
  }
}
Learn more.
/marketplace/orders/search?seller=$SELLER_ID Search one order from a seller. GET
Go back X

Search order by seller

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/marketplace/orders/search?seller.id=523133081
 

Response


        "seller_custom_field": null,
        "variation_attributes": [],
        "category_id": "MLA3530",

    }]
  }]
}
Leer más.
/sites/$SITE_ID/payment_methods Returns the payment methods provided by Mercado Pago. GET
Go back X

Returns data for a payment

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/sites/MLM/payment_methods
 

Response

[
    {
        "id": "visa",
        "name": "Visa",
        "payment_type_id": "credit_card",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/visa.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/visa.gif"
    },
    {
        "id": "amex",
        "name": "American Express",
        "payment_type_id": "credit_card",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/amex.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/amex.gif"
    },
    {
        "id": "master",
        "name": "Mastercard",
        "payment_type_id": "credit_card",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/master.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/master.gif"
    },
    {
        "id": "debmaster",
        "name": "Mastercard Débito",
        "payment_type_id": "debit_card",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/debmaster.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/debmaster.gif"
    },
    {
        "id": "debvisa",
        "name": "Visa Débito",
        "payment_type_id": "debit_card",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/debvisa.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/debvisa.gif"
    },
    {
        "id": "mercadopagocard",
        "name": "Tarjeta MercadoPago",
        "payment_type_id": "prepaid_card",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/mercadopagocard.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/mercadopagocard.gif"
    },
    {
        "id": "serfin",
        "name": "Santander",
        "payment_type_id": "atm",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/2016.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/2016.gif"
    },
    {
        "id": "oxxo",
        "name": "OXXO",
        "payment_type_id": "ticket",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/2017.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/2017.gif"
    },
    {
        "id": "account_money",
        "name": "Dinero en mi cuenta de MercadoPago",
        "payment_type_id": "account_money",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/2018.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/2018.gif"
    },
    {
        "id": "bancomer",
        "name": "BBVA Bancomer",
        "payment_type_id": "atm",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/2014.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/2014.gif"
    },
    {
        "id": "banamex",
        "name": "Citibanamex",
        "payment_type_id": "atm",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/2015.gif",
        "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/2015.gif"
    },
    {
        "id": "consumer_credits",
        "name": "Mercado Crédito",
        "payment_type_id": "digital_currency",
        "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/consumer_credits.gif",
        "secure_thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/consumer_credits.gif"
    }
]
Learn more.
/sites/$SITE_ID/payment_methods/$id Returns the detail of the specific payment method. GET
Go back X

Get payment method

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/sites/MLM/payment_methods/visa
 

Response

{
  "name": "Visa",
  "id": "visa",
  "payment_type_id": "credit_card",
  "card_issuer": {},
  "site_id": "MLM",
  "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/visa.gif",
  "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/visa.gif",
  "labels": [],
  "total_financial_cost": null,
  "min_accreditation_days": 0,
  "max_accreditation_days": 2,
  "payer_costs": [],
  "deferred_capture": "supported",
  "exceptions_by_card_issuer": [],
  "card_configuration": []
}
/marketplace/orders/$ORDER_ID/invoice Get the "proforma" invoice to be used for customs declarations. GET
Go back X

Get an order invoice

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/marketplace/orders/2315686468/invoice
 

Response:
Get the "proforma" invoice to be used for customs declarations.

Learn more.