Criar caixa - Caixas - Mercado Pago Developers
Criar caixa

POST

/pos
Gerar um ponto de venda em uma loja. Cada caixa registradora terá um código QR exclusivo vinculado a ela.
Parâmetros de requisição
category
number
Localização: bodyCódigo MCC que indica a categoria do ponto de venda. Se não especificado, ele permanece como uma categoria genérica
Gastronomy:
621102: Argentina
5611203: Brazil
5812: Mexico
5611: Colombia
5520: Peru
56101: Uruguay
561000: Chile
Gas station:
473000: Argentina
4731300: Brazil
468419: Mexico
4731: Colombia
5050: Peru
47300: Uruguay
473001: Chile
external_id
string
Localização: bodyIdentificador único da caixa definido pelo sistema integrador
external_store_id
string
Localização: bodyExternal_id da loja a que a caixa pertence, definido pelo sistema integrador
fixed_amount
boolean
Localização: bodyDetermine se o cliente pode inserir o valor a ser pago
Parâmetros de resposta
id
number
Localização: bodyid
qr
object
Localização: bodyqr
status
string
Localização: bodystatus
date_created
string
Localização: bodydate_created
Solicitação
curl
curl -X POST \
    'https://api.mercadopago.com/pos' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -d '{
  "name": "First POS",
  "fixed_amount": false,
  "store_id": 1234567,
  "external_store_id": "SUC001",
  "external_id": "SUC001POS001",
  "category": 621102
}'
Resposta
json
{
  "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-22T14:11:12.000Z",
  "uuid": "0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1",
  "user_id": 446566691,
  "name": "First POS",
  "fixed_amount": false,
  "category": 621102,
  "store_id": 1234567,
  "external_store_id": "SUC001",
  "external_id": "SUC001POS001"
}
Erros
400bad_request
MISSING_BODYO corpo HTTP é necessário para criar caixas.
UNKNOWN_FIELD_EXCEPTIONO campo indicado não é permitido para esta operação ou é desconhecido.
INVALID_NAMENome inválido. Deve ser String.
NAME_TOO_LONGO campo NAME deve ter menos de 45 caracteres.
INVALID_FIXED_AMOUNTO FIXED_AMOUNT deve ser Boolean.
INVALID_CATEGORYO campo CATEGORY deve ser numérico.
UNKNOWN_MCCO CATEGORY deve ser válido para o site do usuário.
INVALID_STORE_IDO campo STORE_ID deve ser numérico.
INVALID_EXTERNAL_STORE_IDEXTERNAL_STORE_ID muste be string
EXTERNAL_STORE_ID_NOT_MATCHO EXTERNAL_STORE_ID não se refere ao STORE_ID indicado.
INEXISTENT_EXTERNAL_STORE_IDO EXTERNAL_STORE_ID não se refere a nenhuma loja existente.
INVALID_EXTERNAL_IDO EXTERNAL_ID deve ser alfanumérico, apenas letras e números. Sem espaços ou hífens ou caracteres especiais.
EXTERNAL_ID_TOO_LONGO campo EXTERNAL_ID deve ter menos de 40 caracteres.
INVALID_URLThe URL must be string and muste have the format of a valid url
URL_TOO_LONGO campo URL deve ter menos de 40 caracteres.
FIXED_AMOUNT_FALSESe o campo URL for indicado, o campo FIXED_AMOUNT deve ser true.
403bad_request
1Se você estiver usando o campo URL, o host deve ser ativado pelo Mercado Pago. Caso contrário, você receberá este erro. Entre em contato com o consultor técnico designado.
404bad_request
1Se o caixa não existir para um ID indicado ou EXTERNAL_ID e usuário.
409bad_request
1Uma caixa com o mesmo EXTERNAL_ID já existe.