/pos
BASE URI https://api.mercadopago.com/pos
HTTP Request
curl
curl -X GET \
'https://api.mercadopago.com/pos' \
-H 'Authorization: Bearer PROD_ACCESS_TOKEN'
Request Params
ParameterTypeDescription
category
Long
MCC code that indicates the category of the Point of Sale. If not specified, it remains as a generic category.
Argentina
Gastronomy - 621102
Gas station - 473000
Gas station - 473000
Brasil
Gastronomy - 5611203
Gas station - 4731300
Gas station - 4731300
Mexico
Gastronomy - 5812
Gas station - 468419
Gas station - 468419
Colombia
Gastronomy - 5611
Gas station - 4731
Gas station - 4731
Peru
Gastronomy - 5520
Gas station - 5050
Gas station - 5050
Uruguay
Gastronomy - 56101
Gas station - 47300
Gas station - 47300
Chile
Gastronomy - 561000
Gas station - 473001
Gas station - 473001
store_id
String
Store identifier to which the point of sale belongs.
external_store_id
String
External_id of the store to which the pos belongs defined by integrator system. (Required)
external_id
String
Unique identifier of the pos defined by integrator system.
HTTP Response
json
{
"paging": {
"total": 2,
"offset": 0,
"limit": 0
},
"results": [
{
"user_id": 446566691,
"name": "Caja Principal",
"fixed_amount": true,
"category": 621102,
"store_id": "12345678",
"external_id": "CAJA001",
"id": 1988157,
"qr": {
"image": "https://www.mercadopago.com/instore/merchant/qr/1988157/1f1da6401a4645e99fa21d3f4ffe0e702c4eab2209784fce9d45c83fa93bd5a7.png",
"template_document": "https://www.mercadopago.com/instore/merchant/qr/1988157/template_1f1da6401a4645e99fa21d3f4ffe0e702c4eab2209784fce9d45c83fa93bd5a7.pdf",
"template_image": "https://www.mercadopago.com/instore/merchant/qr/1988157/template_1f1da6401a4645e99fa21d3f4ffe0e702c4eab2209784fce9d45c83fa93bd5a7.png"
},
"date_created": "2019-06-24T09:31:56.000-04:00",
"date_last_updated": "2019-08-07T17:07:26.000-04:00",
"external_store_id": "SUC001"
},
{
"user_id": 446566691,
"name": "Caja Secundaria",
"fixed_amount": true,
"category": 473000,
"store_id": "12345678",
"external_id": "CAJA002",
"id": 1988156,
"qr": {
"image": "https://www.mercadopago.com/instore/merchant/qr/1988157/1f1da6401a4645e99fa21d3f4ffe0e702c4eab2209784fce9d45c83fa93bd5a7.png",
"template_document": "https://www.mercadopago.com/instore/merchant/qr/1988157/template_1f1da6401a4645e99fa21d3f4ffe0e702c4eab2209784fce9d45c83fa93bd5a7.pdf",
"template_image": "https://www.mercadopago.com/instore/merchant/qr/1988157/template_1f1da6401a4645e99fa21d3f4ffe0e702c4eab2209784fce9d45c83fa93bd5a7.png"
},
"date_created": "2019-06-24T09:31:56.000-04:00",
"date_last_updated": "2019-08-07T17:07:26.000-04:00",
"external_store_id": "SUC001"
}
]
}
Error Codes
CodeDescription
400 BAD_REQUEST
INVALID_CATEGORY
The CATEGORY must be numeric.
INVALID_STORE_ID
The STORE_ID must be numeric.
INVALID_EXTERNAL_STORE_ID
The EXTERNAL_STORE_ID must be string.
INEXISTENT_EXTERNAL_STORE_ID
The EXTERNAL STORE_ID does not refer to an existing Store.
INVALID_EXTERNAL_ID
The EXTERNAL_ID field must be alphanumeric, only letters and numbers. No spaces or hyphens, or special characters.
EXTERNAL_ID_TOO_LONG
The EXTERNAL_ID must be less than 40 characters.
INVALID_LIMIT
The LIMIT must be numeric.
INVALID_OFFSET
The OFFSET must be numeric.