Home
Documentation
Resources
Partners
Community

Resources

Check for updates on our solutions and system performance, or request technical support.

Partners

Discover our program for agencies or developers that offer integration services and sellers who want to hire them.

Community

Get the latest news, ask others for help and share your knowledge.

Update store - Physical stores - Mercado Pago Developers

Intelligent search powered by OpenAI 

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. It is essential that this field is filled with the accurate location data of the store, as this can prevent issues related to tax collection. Additionally, correct completion ensures that your store has v...View more
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-8971*********918-01191*********5874530a4*********4799fdf-1*********' \
    -d '{
  "name": "Sucursal Instore",
  "business_hours": {
    "monday": [
      {
        "open": "08:00",
        "close": "12:00"
      }
    ],
    "tuesday": [
      {
        "open": "09:00",
        "close": "18:00"
      }
    ]
  },
  "external_id": "SUC001",
  "location": {
    "street_number": "3040",
    "street_name": "Example Street Name.",
    "city_name": "City name.",
    "state_name": "State name.",
    "latitude": 27.175193925922862,
    "longitude": 78.04213533235064,
    "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, 0123, City name, State name.",
    "latitude": 27.175193925922862,
    "longitude": 78.04213533235064,
    "reference": "Near to Mercado Pago"
  },
  "external_id": "SUC002",
  "date_created": "2019-08-08T19:29:45.019Z"
}