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.

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

Localization: bodyUnique identifier of the pos defined by integrator system.

Localization: bodyExternal_id of the store to which the pos belongs defined by integrator system.

Localization: bodyDefine if the customer can insert the amount to be paid.

Localization: bodyid

Localization: bodyqr

Localization: bodystatus

Localization: bodydate_created

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
}'

{
  "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"
}

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.