What are you looking for?
Do not know how to start integrating?
Check the first stepsCreate store
POST
Products that use it:
Request's parameters
PATH
user_id
User Idstring
REQUIRED
BODY
business_hours
Business hours. They are divided by day of the week and up to two opening and closing times per day are allowed.object
external_id
Unique identifier of the store defined by integrator system.string
location
Store location.object
name
Store name.string
Response parameters
id
idstring
name
namestring
date_created
date_createdstring
business_hours
business_hoursobject
Errors
400Error
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.
VALIDATION_ERROR
External_id-already-used-
Did you find this information useful?
Yes
No
Request
curl -X POST \
'https://api.mercadopago.com/users/{user_id}/stores'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
-d '{
"business_hours": {
"monday": [
{
"open": "08:00",
"close": "12:00"
}
],
"tuesday": [
{
"open": "09:00",
"close": "18:00"
}
]
},
"external_id": "SUC001",
"location": {
"street_number": "3039",
"street_name": "Rua Ângelo Piva",
"city_name": "Osasco",
"state_name": "São Paulo",
"latitude": -32.8897322,
"longitude": -68.8443275,
"reference": "Melicidade"
},
"name": "Sucursal Instore"
}'Sample answer
{
"id": 1234567,
"name": "Sucursal Instore",
"date_created": "2019-08-08T19:29:45.019Z",
"business_hours": {
"monday": [
{
"open": "08:00",
"close": "12: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": "SUC001"
}