Este endpoint permite atualizar os dados de um caixa (ponto de venda). Para utilizá-lo, forneça o ID do caixa e envie apenas os parâmetros que deseja atualizar. Todos os campos são opcionais. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
PATCH
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO CONDICIONAL
id. Apenas dígitos são permitidos. O limite máximo permitido é deOBRIGATÓRIO CONDICIONAL
external_id. Obrigatório se store_id não for enviado. Se ambos foremactive (o caixa está ativado e disponível para receber pagamentos) e inactive (o caixa está desativado e não pode receber pagamentos).400Requisição inválida
bad_request
A requisição não pôde ser processada. Verifique se o body está em conformidade com o JSON schema, o caixa pertence ao usuário do Access Token, o header X-Idempotency-Key está presente e não está vazio, e o domínio da URL no config está registrado e ativo como integrador.
resource_bad_request_error
O pos_id fornecido no path não é um integer válido ou é negativo. Verifique se o valor é um integer base-10 não negativo.
idempotency_key_already_used
O valor do X-Idempotency-Key enviado já foi utilizado em uma requisição anterior com um payload diferente. Gere um novo valor único para cada operação distinta.
invalid_operating_mode
O valor enviado para config.qr.operating_mode não é válido. Os valores aceitos são: self_service, unattended, pdv, standalone.
401Não autorizado
unauthorized
O valor enviado como Access Token está incorreto ou ausente. Verifique e tente novamente com um Access Token válido.
404Não encontrado
pos_not_found
Nenhum caixa foi encontrado para o pos_id fornecido e o usuário do Access Token. Verifique se o ID está correto e pertence à sua conta.
store_not_found
A loja identificada por store_id ou external_store_id não existe ou não pertence ao usuário do Access Token.
409Conflito
conflict
A mesma requisição já está sendo processada por outra chamada concorrente com o mesmo X-Idempotency-Key. Aguarde alguns segundos e tente novamente com a mesma chave e o mesmo payload.
424Falha de dependência
internal_error_check_store_owner
Ocorreu um erro de comunicação ao validar a propriedade da loja. Trata-se de uma falha de dependência e não está relacionado aos dados da requisição. Tente novamente.
500Erro interno do servidor
internal_server_error
Ocorreu um erro inesperado no servidor. Trata-se de uma falha transitória não relacionada aos dados da requisição. Tente novamente após alguns instantes.
curl -X PATCH \
'https://api.mercadopago.com/v2/pos/{pos_id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
-H 'X-Idempotency-Key: 9853543c-fe15-4a7d-bbfe-6aae59659575' \
-d '{
"name": "POS-001",
"store_id": "987654",
"external_id": "SUC001POS002",
"config": {
"qr": {
"operating_mode": "pdv",
"category": 621102,
"url": "https://integrator.example.com/qr/order"
}
}
}'{
"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": "SUC001POS002",
"config": {
"qr": {
"operating_mode": "pdv"
}
},
"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"
}
}