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.

Buscar em lojas - Lojas físicas - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Buscar em lojas

GET

https://api.mercadopago.com/users/{user_id}/stores/search
Este endpoint permite encontrar todas as informações das lojas criadas utilizando filtros específicos. 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.
QUERY
external_id
string
Identificador único da loja, definido pelo sistema integrador e pode conter até 60 caracteres.
Parâmetros de resposta
paging
object
Paginação: Este objeto contém os parâmetros de resposta utilizados para controlar a apresentação dos dados em páginas.
results
array
Resultados.
Erros

400Erro

INVALID_USER_ID

user_id must be a number - Caso este erro apareça, certifique-se de que o user_id fornecido seja estritamente numérico.

INVALID_OFFSET

offset must be a number - Se encontrar este erro, verifique se o offset é um valor numérico.

INVALID_LIMIT

limit must be a number - Caso este erro ocorra, por favor, verifique se o limit está especificado como um valor numérico.

INVALID_EXTERNAL_ID

external_id must be alphanumeric - Caso este erro apareça, certifique-se de que o external_id contenha apenas letras e números.

403Erro

Forbidden

`You don't have permission to access the URL on this server.` Caso receba esta mensagem, verifique o campo user_id e garanta que ele esteja correto e seja somente numérico.

404Erro

store_not_found

`Store not found.` Verifique se o parâmetro de busca utilizado para localizar a loja é válido e faça uma nova requisição.

Requisição
curl -X GET \
    'https://api.mercadopago.com/users/{user_id}/stores/search?external_id=SUC001'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-4599*********755-11221*********d497ae962*********ecf8d85-1*********' \
    
Resposta de exemplo
[
  {
    "paging": {
      "total": 1,
      "offset": 0,
      "limit": 30
    },
    "results": [
      {
        "id": 30163646,
        "name": "Sucursal Instore",
        "date_creation": "2021-04-16T14:54:28.573Z",
        "business_hours": {
          "monday": [
            {
              "open": "08:00",
              "close": "13:00"
            }
          ],
          "tuesday": [
            {
              "open": "09:00",
              "close": "18:00"
            }
          ],
          "wednesday": [
            {
              "open": "07:00",
              "close": "18:00"
            }
          ]
        },
        "location": {
          "address_line": "Example Street Name, 0123, City name, State name.",
          "reference": "3er Piso",
          "latitude": 27.175193925922862,
          "longitude": 78.04213533235064
        },
        "external_id": "SUC001"
      }
    ]
  }
]