Inicio
Documentação
Recursos
Parcerias
Comunidade

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"
}