Inicio
DocumentaciĂłn
Recursos
Partners
Comunidad

Recursos

Revisa las actualizaciones de nuestras soluciones y operatividad del sistema o pide soporte técnico.

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.

Buscar en sucursales - Sucursales fĂ­sicas - Mercado Pago Developers

BĂșsqueda inteligente powered by OpenAI 

Buscar en sucursales

GET

https://api.mercadopago.com/users/{user_id}/stores/search
Este endpoint le permite encontrar toda la informaciĂłn sobre las tiendas creadas utilizando filtros especĂ­ficos. 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.
QUERY
external_id
string
Identificador Ășnico de la tienda, establecido por el sistema integrador y puede contener hasta 60 caracteres.
ParĂĄmetros de respuesta
paging
object
PaginaciĂłn: Este objeto contiene los parĂĄmetros de respuesta utilizados para controlar la presentaciĂłn de los datos en pĂĄginas.
results
array
Resultados.
Errores

400Error

INVALID_USER_ID

user_id must be a number - Si este error aparece, asegĂșrese de que el user_id proporcionado sea estrictamente numĂ©rico.

INVALID_OFFSET

offset must be a number - Si encuentra este error, verifique que el offset sea un valor numérico.

INVALID_LIMIT

limit must be a number - En caso de que este error ocurra, por favor verifique que el limit esté especificado como un valor numérico.

INVALID_EXTERNAL_ID

external_id must be alphanumeric - Si este error aparece, asegĂșrese de que el external_id contenga solo letras y nĂșmeros.

403Error

Forbidden

`You don't have permission to access the URL on this server.` Si recibe este mensaje, verifique el campo user_id y asegĂșrese de que sea correcto y solo numĂ©rico.

404Error

store_not_found

`Store not found.` Verifique si el parĂĄmetro de bĂșsqueda utilizado para localizar la tienda es vĂĄlido y haga una nueva solicitud.

Solicitud
curl -X GET \
    'https://api.mercadopago.com/users/{user_id}/stores/search?external_id=SUC001'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    
Respuesta de ejemplo
[
  {
    "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"
      }
    ]
  }
]