/users/:user_id/stores
BASE URI https://api.mercadopago.com/users/{user_id}/stores
HTTP Request
curl
curl -X POST \
'https://api.mercadopago.com/users/USER_ID/stores' \
-H 'Authorization: Bearer PROD_ACCESS_TOKEN' \
-d '{
"name":"Sucursal Instore",
"business_hours":{
"monday":[
{
"open":"08:00",
"close":"12:00"
},
{
"open":"14:00",
"close":"18:00"
}
],
"tuesday":[
{
"open":"09:00",
"close":"18:00"
}
]
},
"location":{
"street_number":"3039",
"street_name":"Caseros",
"city_name":"Belgrano",
"state_name":"Capital Federal",
"latitude":-32.8897322,
"longitude":-68.8443275,
"reference":"3er Piso"
},
"external_id":"1234"
}'
Request Params
ParameterTypeDescription
id
String
Store identifier, numerical and self-generated.
name
String
Store name. (Required)
business_hours
String
Business hours. They are divided by day of the week and up to two opening and closing times per day are allowed.
external_id
String
Unique identifier of the store defined by integrator system.
user_id
String
User identifier.
location
Object
Store location. (Required)
zip_code
String
Zip code.
street_number
Integer
Number. (Required)
street_name
String
Street name. (Required)
city_name
String
City.(Required)
state_name
Object
State. (Required)
latitude
String
Latitude. (Required)
logitude
String
Longitude. (Required)
reference
String
Reference.
HTTP Response
json
{
"id": "1234567",
"name": "Sucursal Instore",
"date_created": "2019-08-08T19:29:45.019Z",
"business_hours": {
"monday": [
{
"open": "08:00",
"close": "12:00"
},
{
"open": "14:00",
"close": "18:00"
}
],
"tuesday": [
{
"open": "09:00",
"close": "18:00"
}
]
},
"location": {
"address_line": "Caseros 3039, Belgrano, Capital Federal",
"latitude":-32.8897322,
"longitude":-68.8443275,
"reference": "3er Piso"
},
"external_id": "1234"
}
Error Codes
CodeDescription
400 BAD_REQUEST
INVALID_USER_ID
USER_ID must be number.
UNKNOWN_FIELD
Unknown field.
INVALID_NAME
Name must be string.
INVALID_BUSINESS_HOURS
BUSINESS_HOURS must be json_object.
INVALID_DAY
Day must be json_array.
INVALID_LOCATION
LOCATION must be json_object.
INVALID_STREET_NAME
STREET_NAME must be string.
INVALID_STREET_NUMBER
STREET_NUMBER must be string.
INVALID_ZIP_CODE
ZIP_CODE must be string.
INVALID_CITY_NAME
CITY_NAME must be string.
INVALID_STATE_NAME
STATE_NAME must be string.
INVALID_LATITUDE
LATITUDE must be number.
INVALID_LONGITUDE
LONGITUDE must be number.
INVALID_REFERENCE
REFERENCE must be string.