Home
Documentation
Resources
Partners
Community

Partners

Discover our program for agencies or developers that offer integration services and sellers who want to hire them.

Community

Get the latest news, ask others for help and share your knowledge.

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

Do not know how to start integrating? 

Check the first steps
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-7434*********159-03141*********cee51edf8*********f94f589-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": {}
}