Este endpoint permite buscar las cajas asociadas al usuario del Access Token, utilizando distintos filtros e información de paginación. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.
GET
REQUERIDO
external_store_id en la misma solicitud.store_id en la misma solicitud.400Solicitud incorrecta
conflicting_store_filters
Los filtros store_id y external_store_id no pueden enviarse simultáneamente en la misma solicitud. Utiliza solo uno de ellos.
invalid_query_param
Uno o más parámetros de consulta contienen un valor inválido. Verifica que category sea un entero válido, offset sea un entero no negativo y limit sea un entero entre 1 y 30.
invalid_store_id
El valor del filtro store_id no es un número válido. Verifica que el valor enviado sea un entero válido.
401No autorizado
unauthorized
El valor enviado como Access Token es incorrecto o está ausente. Por favor, verifícalo e intenta nuevamente con un Access Token válido.
500Error interno del servidor
internal_server_error
Ocurrió un error inesperado en el servidor. Se trata de una falla transitoria no relacionada con los datos de la solicitud. Por favor, vuelve a intentarlo después de unos momentos.
curl -X GET \
'https://api.mercadopago.com/v2/pos?external_id=POS_EXT_01&store_id=987654&external_store_id=STORE_EXT_01&category=473000&limit=30'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
{
"paging": {
"total": 150,
"offset": 0,
"limit": 30
},
"data": [
{
"id": 1234567,
"name": "POS-001",
"status": "active",
"date_created": "2024-01-15T10:30:00Z",
"date_last_updated": "2024-03-01T08:00:00Z",
"user_id": 123456,
"external_id": "SUC001POS001",
"qr_response": {
"uuid": "0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1",
"image": "https://www.mercadopago.com/instore/merchant/qr/1234567/abc123.png",
"template_document": "https://www.mercadopago.com/instore/merchant/qr/1234567/template_abc123.pdf",
"template_image": "https://www.mercadopago.com/instore/merchant/qr/1234567/template_abc123.png",
"qr_code": "00020101021226940014BR.GOV.BCB.PIX2572pix-qr-h.mercadopago.com/instore/h/p/v2/abc123"
},
"config": {
"qr": {
"operating_mode": "pdv"
}
}
}
]
}