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.

Atualizar caixa - Caixas - Mercado Pago Developers

Busca inteligente powered by OpenAI 

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"
}