Inicio
DocumentaciĂłn
Recursos
Partners
Comunidad

Partners

Conoce nuestro programa para agencias o desarrolladores que ofrecen servicios de integraciĂłn y vendedores que quieren contratarlos.

Comunidad

Recibe las Ășltimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Crear sucursal - Sucursales fĂ­sicas - Mercado Pago Developers
¿Qué documentación quieres buscar?

¿No sabes cómo empezar la integración? 

Accede a los primeros pasos
Crear sucursal

POST

https://api.mercadopago.com/users/{user_id}/stores
Este endpoint permite la creaciĂłn de tiendas fĂ­sicas para la venta de productos o servicios. Cada cuenta puede establecer mĂșltiples tiendas. Un estado 200 indica que la solicitud se ha procesado con Ă©xito.
ParĂĄmetros para la solicitud
PATH
user_id
string

REQUERIDO

El user_id corresponde al collector_id. Se trata del user_id de la cuenta de Mercado Pago que recibe el dinero de las ventas, es decir, la cuenta encargada de recaudar los fondos.
BODY
name
string

REQUERIDO

Nombre de la Sucursal
business_hours
object
Horario comercial. Se divide por dĂ­a de la semana y se permiten hasta cuatro horarios de apertura y cierre por dĂ­a.
external_id
string
Identificador Ășnico de la tienda es establecido por el sistema integrador y puede contener hasta 60 caracteres.
location
object

REQUERIDO

UbicaciĂłn de la Sucursal
ParĂĄmetros de respuesta
id
string
ID de creaciĂłn de la tienda. Al registrar una tienda, recibirĂĄs un ID correspondiente. Este ID se puede utilizar para diversas operaciones, incluida la actualizaciĂłn de datos de la tienda.
name
string
Nombre de la sucursal.
date_created
string
Fecha de creaciĂłn de la tienda: este campo muestra la fecha y hora en el formato ISO 8601, como 2024-08-08T19:29:45.019Z.
business_hours
object
Horario comercial. Se divide por dĂ­a de la semana y se permiten hasta cuatro horarios de apertura y cierre por dĂ­a.
Errores

400Error

UNKNOWN_FIELD

Campo desconocido.

INVALID_NAME

The `name` field must be string - AsegĂșrese de que el valor de `name` sea textual, sin caracteres numĂ©ricos ni especiales.

BAD_REQUEST

Errores causados por inconsistencias en la informaciĂłn de la solicitud. Vea a continuaciĂłn las posibles respuestas.

bad_request:

The name of the following parameters is wrong [additional_info.payer] - Este error se muestra cuando `additional_info.payer` se informa incorrectamente. En este caso, revise si el nombre ingresado es correcto y realice una nueva solicitud.

bad_request:

The store coordinates are outside the site - AsegĂșrese de que las coordenadas ingresadas estĂ©n dentro del lugar especificado.

INVALID_BUSINESS_HOURS

The `business_hours` field must be a json_object - Verifique el formato e incluya atributos necesarios como horarios de apertura y cierre.

INVALID_DAY

The `day` field must be a json_array - AsegĂșrese de que el campo contenga un arreglo de nombres de dĂ­as vĂĄlidos.

INVALID_LOCATION

The `location` field must be json_object - Verifique que los detalles de la ubicación como la latitud y longitud estén correctamente formateados como JSON.

INVALID_STREET_NAME

The `street_name` field must be string - Confirme que el campo contenga solo informaciĂłn textual sin caracteres especiales o nĂșmeros.

INVALID_STREET_NUMBER

The `street_number` field must be string - AsegĂșrese de que el campo contenga representaciones textuales de nĂșmeros o caracteres especiales si es necesario.

INVALID_CITY_NAME

The `city_name` field must be a string - Verifique que el campo estĂ© correctamente lleno con nombres de ciudades y no contenga nĂșmeros o caracteres especiales.

INVALID_STATE_NAME

The `state_name` field must be a string - Compruebe que los nombres de estados estén correctamente ingresados sin caracteres numéricos o especiales.

INVALID_REFERENCE

The `reference` field must be a string - AsegĂșrese de que el campo estĂ© lleno de informaciĂłn textual que ayude a identificar la ubicaciĂłn.

VALIDATION_ERROR

Este error se genera debido a un fallo o ausencia en algĂșn campo especĂ­fico. TambiĂ©n puede ocurrir cuando no se proporciona un parĂĄmetro requerido en la solicitud. Verifique la 'description' o el 'message' asociados al error para obtener mĂĄs detalles y proceder con la correcciĂłn adecuada.

validation_error:

`Name must be defined`. Verifique todos os campos obrigatórios e garanta que todos foram preenchidos conforme indicado na descrição.

validation_error:

`Monday exceeds the maximum length of 4 for Opening Hours`. Revise el campo `opening_hours` y asegĂșrese de no exceder el lĂ­mite mĂĄximo de 4 horarios. El dĂ­a de la semana que se devuelve en el cĂłdigo variarĂĄ segĂșn el dĂ­a que estĂ© excediendo la cantidad permitida de horarios.

validation_error:

location.state_name was invalid - Este error ocurre al insertar el nombre de una ciudad que no corresponde a la ciudad previamente definida. Para corregirlo, verifique los campos 'location.state_name' y 'location.city_name' y asegĂșrese de que estĂ©n completados correctamente. TambiĂ©n puede ocurrir cuando hace falta algĂșn parĂĄmetro en el request, por favor valide el 'description' o el 'message' del error para mĂĄs informaciĂłn.

validation_error:

`The business_hours field can't be null`. Por favor, revise el campo `business_hours` e ingrese la informaciĂłn segĂșn las instrucciones.

validation_error:

`Monday has overlapping hours`. Este error ocurre cuando se introducen dĂ­as y horarios que se solapan. El dĂ­a de la semana se devolverĂĄ de acuerdo con los dĂ­as en los que los horarios estĂĄn solapados. Revise los horarios de apertura y asegĂșrese de que ninguno se solape.

validation_error:

`Closing hours must be greater than opening hours`. Revise el parĂĄmetro `business_hours` y asegĂșrese de que los atributos de horarios de apertura y cierre estĂ©n correctos.

403Error

Forbidden

Usted no tiene permiso para realizar esta operaciĂłn. Por favor, contacte con un administrador para obtener ayuda y asegĂșrese de que el user_id utilizado sea el mismo de su cuenta.

Solicitud
curl -X POST \
    'https://api.mercadopago.com/users/{user_id}/stores'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-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": "3039",
    "street_name": "Example Street Name.",
    "city_name": "Buenos Aires",
    "state_name": "Buenos Aires.",
    "latitude": -32.8897322,
    "longitude": -68.8443275,
    "reference": "Near to Mercado Pago"
  }
}'
Respuesta de ejemplo
{
  "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": "Example Street Name, 3039, Buenos Aires, Buenos Aires.",
    "latitude": -32.8897322,
    "longitude": -68.8443275,
    "reference": "Near to Mercado Pago"
  },
  "external_id": "SUC001"
}