Home
Documentation
Resources
Certifications
Community
Create order - Instore Orders - Mercado Pago Developers

Intelligent search powered by OpenAI 

Create order

POST

https://api.mercadopago.com/mpmobile/instore/qr/{user_id}/{external_id}
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
HEADER
X-Ttl-Store-Preference
string

REQUIRED

X-Ttl-Store-Preference
PATH
user_id
string

REQUIRED

User Id
external_id
string

REQUIRED

External Id
BODY
external_reference
string
Reference you can synchronize with your sale system.
notification_url
string
URL where you'd like to receive a payment or merchant_order notification.
sponsor_id
string
Mercado Pago's USER_ID of the integrator system.
items
array
Information on the products involved in the order.
Response parameters
id
string
id
items
array
items
collector_id
number
collector_id
collector
object
collector
Errors

400Error

invalid_collector_id

collector_id invalid.

invalid_sponsor_id

sponsor_id is not an active user.

invalid_items

unit_price invalid.

invalid_access_token

Access denied.

Request
curl -X POST \
    'https://api.mercadopago.com/mpmobile/instore/qr/{user_id}/{external_id}'\
    -H 'Content-Type: application/json' \
       -H 'X-Ttl-Store-Preference: 180' \
       -H 'Authorization: Bearer TEST-2151*********762-03031*********750b665b7*********4dac477-1*********' \
    -d '{
  "external_reference": "Factura-0001",
  "notification_url": "http://www.yourserver.com",
  "sponsor_id": "446566691",
  "items": [
    {
      "id": 78123172,
      "title": "Shampoo",
      "currency_id": "COP",
      "unit_price": 120,
      "quantity": 1,
      "description": "Almendras",
      "picture_url": "https://bit.ly/2nxdWHa"
    }
  ]
}'
Sample answer
{
  "id": "360472057-3d2cadbf-2c54-485c-bcb9-f262adc14af6",
  "items": [
    {
      "title": "Shampoo",
      "id": 78123172,
      "currency_id": "COP",
      "unit_price": 120,
      "quantity": 1,
      "description": "Almendras",
      "picture_url": "https://bit.ly/2nxdWHa"
    }
  ],
  "collector_id": 360472057,
  "collector": {},
  "total_amount": 120,
  "amount": 120,
  "external_reference": "Factura-0001",
  "operation_type": "regular_payment",
  "payment_methods": {
    "excluded_payment_methods": [
      {}
    ],
    "excluded_payment_types": [
      {
        "id": "ticket"
      }
    ]
  },
  "marketplace": "NONE",
  "marketplace_fee": 0,
  "sponsor_id": 446566691,
  "notification_url": "http://www.yourserver.com",
  "back_urls": {},
  "payer": {
    "id": 0,
    "identification": {},
    "address": {},
    "phone": {}
  },
  "site_id": "mla",
  "client_id": 360472057,
  "processing_modes": [
    {}
  ],
  "internal_metadata": {}
}