Create order - Instore Orders v2 - Mercado Pago Developers
Which documentation are you looking for?

Do not know how to start integrating? 

Check the first steps
Create order

PUT

https://api.mercadopago.com/instore/qr/seller/collectors/{user_id}/stores/{external_store_id}/pos/{external_pos_id}/orders
Generate a payment order with all the payment information for your product or service and associate it with the Point of Sale you want.
Request's parameters
PATH
user_id
string

REQUIRED

Find the User ID in your developer dashboard at our devsite
external_store_id
string

REQUIRED

Custom Store ID associated to the order.
external_pos_id
string

REQUIRED

Custom POS ID associated to the order.
BODY
cash_out
object
Cash withdrawal (Commercial contact required)
description
string
Purchase description.
expiration_date
string
Expiration date with format "2020-08-22T16:34:56.559-04:00"
external_reference
string
Custom order ID you can synchronize with your sale system.
Response parameters
Esta solicitação não tem resposta
Errors

400Error

invalid_collectorId

user_id must be a number.

invalid_externalPosId

externalPosId must be present.

invalid_external_reference

external_reference must be present.

invalid_total_amount

total_amount must be present.

invalid_items.sku_number

items.sku_number must be string.

invalid_items.category

items.category must be string.

invalid_items.title

items.title must be string.

invalid_items.description

items.description must be string.

invalid_items.unit_measure

items.unit_measure must be string.

invalid_items.quantity

items.quantity must be number.

invalid_items.currency_id

items.currency_id must be string.

invalid_items.unit_price

items.unit_price must be number.

invalid_items.total_amount

items.total_amount must be number.

invalid_title

title must be string.

invalid_unit_measure

unit_measure must be present.

invalid_quantity

quantity must be present.

invalid_unit_price

unit_price must be present.

invalid_description

description must be present.

invalid_sponsor.id

sponsor.id must be number.

invalid_id

sponsor.id must be present.

invalid_cash_out.amount

cash_out.amount must be number.

invalid_amount

cash_out.amount must be present.

error_creating_seller_qr_order

The cash out is required when order has no items.

invalid_expiration_date

Expiration date must be a valid and future date.

500Error

in_store_order_creation_error

Failed to create order.

Request
curl -X PUT \
    'https://api.mercadopago.com/instore/qr/seller/collectors/{user_id}/stores/{external_store_id}/pos/{external_pos_id}/orders'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
    -d '{
  "cash_out": {
    "amount": 0
  },
  "description": "Purchase description.",
  "external_reference": "12345",
  "items": [
    {
      "sku_number": "A123K9191938",
      "category": "marketplace",
      "title": "Point Mini",
      "description": "This is the Point Mini",
      "unit_price": 100,
      "quantity": 1,
      "unit_measure": "unit",
      "total_amount": 100
    }
  ],
  "notification_url": "http://www.yourserver.com/notification",
  "sponsor": {
    "id": 662208785
  },
  "title": "Product order",
  "total_amount": 100
}'
Sample answer
// This request has not been responded to.