Home
Documentation
Resources
Certifications
Community
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. If the request is successful, the response will be: code 204 - The server successfully processed the request, but is not returning any content.
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
external_reference
string
Custom order ID you can synchronize with your sale system. Important: This field must be a maximum of 64 characters and may only contain numbers, letters, hyphens (-), and underscores (_). Special characters such as ([ ]...View more
title
string
Purchase title.
description
string
Purchase description.
notification_url
string
URL where you'd like to receive a payment or merchant_order notification.
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-2151*********762-03031*********750b665b7*********4dac477-1*********' \
    -d '{
  "external_reference": "12345",
  "title": "Product order",
  "description": "Purchase description.",
  "notification_url": "http://www.yourserver.com/notification",
  "total_amount": 100,
  "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
    }
  ],
  "sponsor": {
    "id": 662208785
  },
  "cash_out": {
    "amount": 0
  }
}'
Sample answer
// This request has not been responded to.