Buscar en sucursales - Sucursales físicas - Mercado Pago Developers
¿Qué estás buscando?

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

Accede a los primeros pasos
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-7719*********832-03141*********ec9309854*********f1e54b5-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, 3039, Buenos Aires, Buenos Aires.",
          "reference": "3er Piso",
          "latitude": -32.8897322,
          "longitude": -68.8443275
        },
        "external_id": "SUC001"
      }
    ]
  }
]