Inicio
Documentação
Recursos
Parcerias
Comunidade

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.

Atualizar caixa - Caixas - Mercado Pago Developers
Qual documentação você quer buscar?

Não sabe como começar a integrar? 

Acesse os primeiros passos
Atualizar caixa

PUT

https://api.mercadopago.com/pos/{id}
Este endpoint permite atualizar os dados de uma caixa (ponto de venda). Para utilizá-lo, é necessário fornecer a identificação do ponto de venda e enviar os parâmetros com as informações a serem atualizadas.
Parâmetros de requisição
PATH
id
string

OBRIGATÓRIO

ID de criação do ponto de venda. Ao registrar um ponto de venda, você receberá um ID correspondente. Esse ID pode ser utilizado para várias operações, incluindo a atualização de dados do ponto de venda.
BODY
name
string
Nome da caixa (ponto de venda).
fixed_amount
boolean
Determine se o cliente pode inserir o valor a ser pago.
category
number
Código MCC que indica a categoria do ponto de venda. Se não especificado, ele permanece como uma categoria genérica
Gastronomy: Gastronomia
621102: Argentina
5611203: Brasil
Ver mais
store_id
string
Identificador da loja à qual o ponto de venda pertence.
Parâmetros de resposta
id
number
ID de criação do ponto de venda. Ao registrar um ponto de venda, você receberá um ID correspondente. Esse ID pode ser utilizado para várias operações, incluindo consultar os dados do ponto de venda.
qr
object
Código QR criado automaticamente para receber os pagamentos do ponto de venda.
status
string
Status da atualização dos dados do ponto de venda.
date_created
string
Data de criação da caixa. Este campo exibe a data e hora no formato ISO 8601, como 2024-08-08T19:29:45.019Z.
Erros

400Erro

MISSING_BODY

O corpo do HTTP é necessário para modificar o ponto de venda.

UNKNOWN_FIELD_EXCEPTION

O campo indicado não é permitido para esta operação ou é desconhecido.

INVALID_POS_ID

O ID do ponto de venda é inválida, deve ser numérica.

INVALID_NAME

NAME deve ser string.

NAME_TOO_LONG

NAME deve ter menos de 45 caracteres.

INVALID_FIXED_AMOUNT

FIXED_AMOUNT deve ser boolean.

INVALID_CATEGORY

CATEGORY deve ser numérico.

POS_UNKNOWN_MCC

CATEGORY deve ser válida para o site do usuário.

POS_INVALID_STORE_ID

STORE_ID deve ser numérico.

INVALID_EXTERNAL_STORE_ID

EXTERNAL_STORE_ID deve ser string.

EXTERNAL_STORE_ID_NOT_MATCH

O EXTERNAL_STORE_ID não se refere ao STORE_ID indicado.

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_URL

A URL deve ser uma string e deve ter o formato de uma URL válida.

URL_TOO_LONG

A URL deve ter menos de 300 caracteres.

FIXED_AMOUNT_FALSE

Se o campo URL estiver indicado, o campo FIXED_AMOUNT deve ser verdadeiro. Não suportamos a modalidade de valor aberto nesse caso.

403Erro

1

Se você estiver usando o campo URL, o host deve ser habilitado pelo Mercado Pago. Se não for, você receberá este erro. Por favor, entre em contato com seu assessor técnico designado.

404Erro

1

Se o ponto de venda não existir para um ID ou EXTERNAL_ID indicado e para o usuário.

409Erro

1

Já existe um ponto de venda com o mesmo EXTERNAL_ID.

Requisição
curl -X PUT \
    'https://api.mercadopago.com/pos/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
    -d '{
  "name": "First POS",
  "fixed_amount": false,
  "category": 621102,
  "store_id": 1234567,
  "external_id": "SUC001POS001",
  "external_store_id": "SUC001"
}'
Resposta de exemplo
{
  "id": 2711382,
  "qr": {
    "image": "https://www.mercadopago.com/instore/merchant/qr/2711382/0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.png",
    "template_document": "https://www.mercadopago.com/instore/merchant/qr/2711382/template_0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.pdf",
    "template_image": "https://www.mercadopago.com/instore/merchant/qr/2711382/template_0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1.png"
  },
  "status": "active",
  "date_created": "2019-08-22T14:11:12.000Z",
  "date_last_updated": "2019-08-25T15:16:12.000Z",
  "uuid": "0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1",
  "user_id": 446566691,
  "name": "First POS",
  "fixed_amount": false,
  "category": 621102,
  "store_id": 1234567,
  "external_store_id": "SUC001",
  "external_id": "SUC001POS002",
  "site": "MLB",
  "qr_code": "00020101021226940014BR.GOV.BCB.PIX2572pix-qr-h.mercadopago.com/instore/h/p/v2/db12b6e2ec4844839825c6dce7cd2f2243530016com.mercadolibre0129https://mpago.la/pos/212798995204000053039865802BR5924VICTOR CORREA DE ALMEIDA6008CAMPINAS62070503***63040B44"
}