Create POS - Points of Sale - Mercado Pago Developers
Create POS

POST

/pos
Generate a Point of Sale in a store. Each POS will have a unique QR Code linked to it.
Request's parameters
category
number
Localization: bodyMCC code that indicates the category of the Point of Sale. If not specified, it remains as a generic category.
Gastronomy:
621102: Argentina
5611203: Brazil
5812: Mexico
5611: Colombia
5520: Peru
56101: Uruguay
561000: Chile
Gas station:
473000: Argentina
4731300: Brazil
468419: Mexico
4731: Colombia
5050: Peru
47300: Uruguay
473001: Chile
external_id
string
Localization: bodyUnique identifier of the pos defined by integrator system.
external_store_id
string
Localization: bodyExternal_id of the store to which the pos belongs defined by integrator system.
fixed_amount
boolean
Localization: bodyDefine if the customer can insert the amount to be paid.
Response parameters
id
number
Localization: bodyid
qr
object
Localization: bodyqr
status
string
Localization: bodystatus
date_created
string
Localization: bodydate_created
Request
curl
curl -X POST \
    'https://api.mercadopago.com/pos' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
  "name": "First POS",
  "fixed_amount": false,
  "store_id": 1234567,
  "external_store_id": "SUC001",
  "external_id": "SUC001POS001",
  "category": 621102
}'
Answer
json
{
  "id": 2711382,
  "qr": {
    "image": "https://www.mercadopago.com/instore/merchant/qr/2711382/0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.png",
    "template_document": "https://www.mercadopago.com/instore/merchant/qr/2711382/template_0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.pdf",
    "template_image": "https://www.mercadopago.com/instore/merchant/qr/2711382/template_0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.png"
  },
  "status": "active",
  "date_created": "2019-08-22T14:11:12.000Z",
  "date_last_updated": "2019-08-22T14:11:12.000Z",
  "uuid": "0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1",
  "user_id": 446566691,
  "name": "First POS",
  "fixed_amount": false,
  "category": 621102,
  "store_id": 1234567,
  "external_store_id": "SUC001",
  "external_id": "SUC001POS001"
}
Errors
400bad_request
MISSING_BODYHTTP body is required to create pos.
UNKNOWN_FIELD_EXCEPTIONThe indicated field is not allowed for this operation or is unknown.
INVALID_NAMENAME must be string.
NAME_TOO_LONGThe NAME must be less than 45 characters.
INVALID_FIXED_AMOUNTFIXED_AMOUNT must be boolean.
INVALID_CATEGORYCATEGORY must be numeric.
UNKNOWN_MCCThe CATEGORY must be valid for the user's site.
INVALID_STORE_IDSTORE_ID must be numeric.
INVALID_EXTERNAL_STORE_IDEXTERNAL_STORE_ID muste be string.
EXTERNAL_STORE_ID_NOT_MATCHThe EXTERNAL_STORE_ID does not refer to the indicated STORE_ID.
INEXISTENT_EXTERNAL_STORE_IDThe EXTERNAL_STORE_ID does not refer to any existing store.
INVALID_EXTERNAL_IDThe EXTERNAL_ID field must be alphanumeric, only letters and numbers. No spaces or hyphens, or special characters.
EXTERNAL_ID_TOO_LONGThe EXTERNAL_ID must be less than 40 characters.
INVALID_URLThe URL must be string and muste have the format of a valid url
URL_TOO_LONGThe URL must be less than 300 characters.
FIXED_AMOUNT_FALSEIf the URL field is indicated, the FIXED_AMOUNT field must be true. We do not support the open amount modality in this case.
403bad_request
1If you are using the URL field, the host must be enabled by Mercado Pago. If it is not, you will receive this error. Please contact your assigned technical advisor.
404bad_request
1If the POS does not exist for an indicated ID or EXTERNAL_ID and user.
409bad_request
1A pos with the same EXTERNAL_ID already exists.