Home
Documentation
Resources
Certifications
Community
Update store - Physical stores - Mercado Pago Developers
Which documentation are you looking for?

Do not know how to start integrating? 

Check the first steps
Update store

PUT

https://api.mercadopago.com/users/{user_id}/stores/{id}
This endpoint allows for updating the data of a physical store. To use it, you must provide the seller's identification and the branch identification, along with the parameters containing the information you wish to update. You will receive a 200 response as a result of a successful request.
Request's parameters
PATH
user_id
string

REQUIRED

The user_id corresponds to the collector_id. It refers to the user_id of the Mercado Pago account that receives the money from sales, that is, the account responsible for collecting the funds.
id
string

REQUIRED

Store creation ID. Upon registering a store, you will receive a corresponding ID. This ID can be used for various operations, including updating the store's data.
BODY
name
string
Store name.
business_hours
object
Business hours. They are divided by day of the week and up to four opening and closing times per day are allowed.
external_id
string
The unique store identifier, set by the integrated system and can contain up to 60 characters.
location
object
Store location.
Response parameters
id
string
Store creation ID. Upon registering a store, you will receive a corresponding ID. This ID can be used for various operations, including updating the store's data.
name
string
Store's name.
date_creation
string
Store creation date. This field displays the date and time in ISO 8601 format, such as 2024-08-08T19:29:45.019Z.
business_hours
object
Business hours. They are divided by day of the week and up to four opening and closing times per day are allowed.
Errors

400Error

bad_request

Field description too long.` If you receive this error, check the external_id parameter and ensure it does not exceed the maximum limit of 60 characters.

bad_request:

`Store coordinates (latitude xxx and longitude xxxx) are invalid`. This error is displayed when invalid coordinates are entered in the latitude and longitude parameters. The 'x' will be replaced by the erroneously added values. Check the longitude and latitude parameters, correct the information, and make a new request.

bad_request:

`external id 'xxx' is already assigned to this user 1234567`. This error is displayed when an external_id that already belongs to another store is entered in the respective field. If you receive this message, check the external_id parameter and ensure it is unique. The characters 'xxx' will be replaced by the erroneously entered information.

INVALID_USER_ID

user_id must be number.

UNKNOWN_FIELD

Unknown field.

INVALID_STORE_ID

Invalid store_id.

INVALID_NAME

The `name` field must be string.

INVALID_BUSINESS_HOURS

The `business_hours` field must be a json_object.

INVALID_DAY

The `day` field must be a json_array.

INVALID_LOCATION

The `location` field must be json_object.

INVALID_STREET_NAME

The `street_name` field must be string.

INVALID_STREET_NUMBER

The `street_number` field must be string.

INVALID_CITY_NAME

The `city_name` field must be a string.

INVALID_STATE_NAME

The `state_name` field must be a string.

INVALID_REFERENCE

The `reference` field must be a string.

validation_error

`Monday exceeds the maximum length of 4 for Opening Hours`. Review the `opening_hours` field and ensure it does not exceed the maximum limit of 4 schedules. The day of the week returned in the code will vary according to the day that is exceeding the allowed number of schedules.

validation_error:

`Monday has overlapping hours`. This error occurs when days and times that overlap are entered. The day of the week will return according to the days when the times are overlapping. Review the opening hours and ensure that none overlap.

validation_error:

`Closing hours must be greater than opening hours`. Review the `business_hours` parameter and ensure that the opening and closing time attributes are correct.

validation_error:

`Monday can't be empty`. This error is displayed whenever a day of the week is submitted empty. The specific day will vary depending on the missing information. Review the business_hours parameters and ensure that all specified days have established hours.

403Error

Forbidden

`You don't have permission to access the URL on this server`. If you receive this error, check if the store_id used is correct and make a new request.

Request
curl -X PUT \
    'https://api.mercadopago.com/users/{user_id}/stores/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
    -d '{
  "name": "Sucursal Instore 2",
  "business_hours": {
    "monday": [
      {
        "open": "08:00",
        "close": "12:00"
      }
    ],
    "tuesday": [
      {
        "open": "09:00",
        "close": "18:00"
      }
    ]
  },
  "external_id": "SUC002",
  "location": {
    "street_number": "3040",
    "street_name": "Example Street Name.",
    "city_name": "Buenos Aires",
    "state_name": "Buenos Aires.",
    "latitude": -32.8897322,
    "longitude": -68.8443275,
    "reference": "Near to Mercado Pago"
  }
}'
Sample answer
{
  "id": 1234567,
  "name": "Store name",
  "date_creation": "2024-08-08T19:29:45.019Z",
  "business_hours": {
    "monday": [
      {
        "open": "08:00",
        "close": "12:00"
      }
    ]
  },
  "location": {
    "address_line": "Example Street Name, 3039, Buenos Aires, Buenos Aires.",
    "latitude": -32.8897322,
    "longitude": -68.8443275,
    "reference": "Near to Mercado Pago"
  },
  "external_id": "SUC002",
  "date_created": "2019-08-08T19:29:45.019Z"
}