Inicio
Documentação
Recursos
Parcerias
Comunidade

Recursos

Confira as atualizações das nossas soluções e do funcionamento do sistema ou peça suporte técnico.

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 caixas - Caixas - Mercado Pago Developers

Busca inteligente powered by OpenAI 

Buscar em caixas

GET

https://api.mercadopago.com/pos
Este endpoint permite encontrar todas as informações das caixas (pontos de venda) criadas utilizando filtros específicos.
Parâmetros de requisição
QUERY
external_id
string
Identificador único da caixa definido pelo sistema integrador.
external_store_id
string
Identificador único da loja, definido pelo sistema integrador e pode conter até 60 caracteres.
store_id
string
Identificador da loja à qual o ponto de venda pertence.
category
string
Código MCC que indica a categoria do ponto de venda. Se não especificado, ele permanece como uma categoria genérica.
Parâmetros de resposta
paging
object
Informações para paginação dos resultados da pesquisa.
results
array
Resultados encontrados a partir dos filtros utilizados para busca.
Erros

400Erro

INVALID_CATEGORY

CATEGORY deve ser numérico.

INVALID_STORE_ID

STORE_ID deve ser numérico.

INVALID_EXTERNAL_STORE_ID

EXTERNAL_STORE_ID deve ser string.

INEXISTENT_EXTERNAL_STORE_ID

O EXTERNAL_STORE_ID não se refere a uma loja existente.

INVALID_EXTERNAL_ID

O campo EXTERNAL_ID deve ser alfanumérico, apenas letras e números. Sem espaços, hífens ou caracteres especiais.

EXTERNAL_ID_TOO_LONG

O EXTERNAL_ID deve ter menos de 40 caracteres.

INVALID_LIMIT

LIMIT deve ser numérico.

INVALID_OFFSET

OFFSET deve ser numérico.

Requisição
curl -X GET \
    'https://api.mercadopago.com/pos?external_id=SUC001POS001'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-4599*********755-11221*********d497ae962*********ecf8d85-1*********' \
    
Resposta de exemplo
{
  "paging": {
    "total": 1,
    "offset": 0,
    "limit": 0
  },
  "results": [
    {
      "user_id": 446566691,
      "name": "Caja Principal",
      "category": 621102,
      "store_id": 1234567,
      "external_id": "SUC001POS001",
      "id": 1988157,
      "qr": {
        "image": "https://www.mercadopago.com/instore/merchant/qr/1988157/1f1da6401a4645e99fa21d3f4ffe0e702c4eab2209784fce9d45c83fa93bd5a7.png",
        "template_document": "https://www.mercadopago.com/instore/merchant/qr/1988157/template_1f1da6401a4645e99fa21d3f4ffe0e702c4eab2209784fce9d45c83fa93bd5a7.pdf",
        "template_image": "https://www.mercadopago.com/instore/merchant/qr/1988157/template_1f1da6401a4645e99fa21d3f4ffe0e702c4eab2209784fce9d45c83fa93bd5a7.png"
      },
      "date_created": "2019-06-24T13:31:56.000Z",
      "date_last_updated": "2019-08-25T15:16:12.000Z",
      "external_store_id": "SUC001"
    }
  ]
}