Inicio
Documentação
Recursos
Parcerias
Comunidade

Recursos

Confira as atualizaçÔes das nossas soluçÔes e do funcionamento do sistema ou peça suporte técnico.

Parcerias

Conheça nosso programa para agĂȘncias ou desenvolvedores que oferecem serviços de integração e vendedores que desejam contratĂĄ-los.

Comunidade

Fique por dentro das Ășltimas novidades, peça ajuda a outros integradores e compartilhe seu conhecimento.

Criar loja - Lojas fĂ­sicas - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Criar loja

POST

https://api.mercadopago.com/users/{user_id}/stores
Este endpoint possibilita a criação de lojas fĂ­sicas para a venda de produtos ou serviços. Cada conta pode estabelecer mĂșltiplas lojas. Um status 200 indica que a solicitação foi processada com sucesso.
Parùmetros de requisição
PATH
user_id
string

OBRIGATÓRIO

O user_id corresponde ao collector_id. Trata-se do user_id da conta do Mercado Pago que recebe o dinheiro das vendas, ou seja, a conta responsåvel pela arrecadação dos valores.
BODY
name
string

OBRIGATÓRIO

Nome da loja
business_hours
object
Horårio comercial. Eles são divididos por dia da semana e são permitidos até quatro horårios de abertura e fechamento por dia.
external_id
string
Identificador Ășnico da loja Ă© definido pelo sistema integrador e pode conter atĂ© 60 caracteres.
location
object

OBRIGATÓRIO

Localização da loja. É fundamental que este campo seja preenchido com os dados reais da localização da loja, pois isso pode evitar problemas relacionados Ă  cobrança de impostos. AlĂ©m disso, o preenchimento correto garant...Ver mais
ParĂąmetros de resposta
id
string
ID de criação da loja. Ao registrar uma loja, vocĂȘ receberĂĄ um ID correspondente. Esse ID pode ser utilizado para vĂĄrias operaçÔes, incluindo a atualização de dados da loja.
name
string
Nome da loja.
date_created
string
Data de criação da loja: este campo exibe a data e hora no formato ISO 8601, como 2024-08-08T19:29:45.019Z.
business_hours
object
Horårio comercial. Eles são divididos por dia da semana e são permitidos até quatro horårios de abertura e fechamento por dia.
Erros

400Erro

UNKNOWN_FIELD

Campo desconhecido.

INVALID_NAME

The `name` field must be string - Garanta que o valor de `name` seja textual, sem caracteres numéricos ou especiais.

BAD_REQUEST

Erros causados por inconsistĂȘncias nas informaçÔes do request. Veja abaixo os possĂ­veis retornos.

bad_request:

The name of the following parameters is wrong [additional_info.payer] - Esse erro é exibido quando em additional_info.payer é informado erroneamente. Neste caso, revise se o nome inserido estå correto e faça uma nova requisição.

bad_request:

The store coordinates are outside the site - Garanta que as coordenadas inseridas estejam dentro do local determinado.

INVALID_BUSINESS_HOURS

The `business_hours` field must be a json_object - Verifique o formato e inclua atributos necessĂĄrios como horĂĄrios de abertura e fechamento.

INVALID_DAY

The `day` field must be a json_array - Certifique-se de que o campo contenha um array de nomes de dias vĂĄlidos.

INVALID_LOCATION

The `location` field must be json_object - Verifique se os detalhes da localização, como latitude e longitude, estão corretamente formatados como JSON.

INVALID_STREET_NAME

The `street_name` field must be string - Confirme que o campo contenha apenas informaçÔes textuais, sem caracteres especiais ou nĂșmeros.

INVALID_STREET_NUMBER

The `street_number` field must be string - Garanta que o campo contenha representaçÔes textuais de nĂșmeros ou caracteres especiais, se necessĂĄrio.

INVALID_CITY_NAME

The `city_name` field must be a string - Verifique se o campo estĂĄ corretamente preenchido com nomes de cidades e nĂŁo contĂ©m nĂșmeros ou caracteres especiais.

INVALID_STATE_NAME

The `state_name` field must be a string - Verifique se os nomes dos estados estão corretamente inseridos, sem caracteres numéricos ou especiais.

INVALID_REFERENCE

The `reference` field must be a string - Garanta que o campo esteja preenchido com informaçÔes textuais que ajudem a identificar a localização.

VALIDATION_ERROR

Este erro Ă© gerado devido a uma falha ou ausĂȘncia em algum campo especĂ­fico. TambĂ©m pode ocorrer quando um parĂąmetro necessĂĄrio nĂŁo Ă© fornecido na solicitação. Verifique a 'description' ou o 'message' associados ao erro para obter mais detalhes e proceder com a correção adequada.

validation_error:

`Name must be defined`. Verifique todos los campos obligatorios y asegĂșrese de que todos se hayan completado segĂșn lo indicado en la descripciĂłn.

validation_error:

`Monday exceeds the maximum length of 4 for Opening Hours`. Revise o campo `opening_hours` e garanta nĂŁo exceder o limite mĂĄximo de 4 horĂĄrios. O dia da semana retornado no cĂłdigo irĂĄ variar de acordo com o dia que estĂĄ excedendo a quantidade de horĂĄrios permitida.

validation_error:

location.state_name was invalid - Esse erro ocorre ao inserir o nome de uma cidade que não corresponde à cidade previamente definida. Para corrigi-lo, verifique os campos 'location.state_name' e 'location.city_name' e certifique-se de que estejam preenchidos corretamente. Também pode ocorrer quando falta algum parùmetro na solicitação, por favor, valide a 'description' ou o 'message' do erro para mais informaçÔes.

validation_error:

`The business_hours field can't be null`. Verifique o campo `business_hours` e insira as informaçÔes conforme orientação.

validation_error:

`Monday has overlapping hours`. Este erro ocorre quando se insere dias e horårios que se sobrepÔem. O dia da semana retornarå de acordo com os dias em que os horårios estão sobrepostos. Revise os horårios de abertura e garanta que nenhum se sobreponha.

validation_error:

`Closing hours must be greater than opening hours`. Revise o parĂąmetro `business_hours` e garanta que os atributos de horĂĄrios de abertura e encerramento estejam corretos.

403Erro

Forbidden

VocĂȘ nĂŁo tem permissĂŁo para realizar esta operação. Por favor, entre em contato com um administrador para obter ajuda e garanta que o user_id utilizado seja o mesmo da sua conta.

Requisição
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": "0123",
    "street_name": "Example Street Name.",
    "city_name": "City name.",
    "state_name": "State name.",
    "latitude": 27.175193925922862,
    "longitude": 78.04213533235064,
    "reference": "Near to Mercado Pago"
  }
}'
Resposta de exemplo
{
  "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, 0123, City name, State name.",
    "latitude": 27.175193925922862,
    "longitude": 78.04213533235064,
    "reference": "Near to Mercado Pago"
  },
  "external_id": "SUC001"
}