/pos/:id

BASE URI https://api.mercadopago.com/pos/{id}

HTTP Request

curl

 curl -X PUT \
   'https://api.mercadopago.com/pos/ID?access_token=PROD_ACCESS_TOKEN' \
    -d '{
     "name":"Caja Secundaria", 
     "fixed_amount": false,
     "category": 473000,
     "store_id": "123456",
     "external_store_id": "BK022",
     "url": "https://www.myserver.com?pos=001"
}' 

Request Params

ParameterTypeDescription
id String Identificador exclusivo da caixa, numérico e gerado automaticamente.
name String Nome da caixa.
fixed_amount Boolean Determine se o cliente pode inserir o valor a ser pago.
true O cliente não pode escolher o valor a ser pago, deve aguardar a geração de um pedido.
false Depois de ler o código QR da caixa, o cliente digita o valor a ser pago.
category Long Código MCC que indica a categoria do ponto de venda. Se não especificado, ele permanece como uma categoria genérica
Argentina Gastronomia - 621102
Posto de combustível - 473000
Brasil Gastronomia - 5611203
Posto de combustível - 4731300
Mexico Gastronomia - 5812
Posto de combustível - 468419
Colombia Gastronomia - 5611
Posto de combustível - 4731
Peru Gastronomia - 5520
Posto de combustível - 5050
Uruguay Gastronomia - 56101
Posto de combustível - 47300
Chile Gastronomia - 561000
Posto de combustível - 473001
store_id String Identificador da loja à qual o caixa pertence.
external_store_id String Identificador único da loja a que a caixa pertence, definido pelo sistema integrador.
url String URL para obter a ordem do sistema integrador. É opcional e é usado apenas no modelo de integração autônoma.

HTTP Response

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-22T10:11:12.000-04:00",
    "date_last_updated": "2019-08-22T10:11:12.000-04:00",
    "uuid": "0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1",
    "user_id": 446566691,
    "name": "Caja Secundaria",
    "fixed_amount": false,
    "category": 473000,
    "store_id": "123456",
    "external_store_id": "BK022",
    "url": "https://www.myserver.com?pos=001",
    "external_id": "4lph4num3r1c"
} 

Error Codes

CodeDescription
400 BAD_REQUEST
MISSING_BODY O corpo HTTP é necessário para modificar caixas.
UNKNOWN_FIELD_EXCEPTION O campo indicado não é permitido para esta operação ou é desconhecido.
INVALID_POS_ID O ID da caixa é inválido, deve ser numérico.
INVALID_NAME O NAME deve ser String.
NAME_TOO_LONG O campo NAME deve ter menos de 45 caracteres.
INVALID_FIXED_AMOUNT O FIXED_AMOUNT deve ser Boolean.
INVALID_CATEGORY O campo CATEGORY deve ser numérico.
POS_UNKNOWN_MCC O CATEGORY deve ser válido para o site do usuário.
POS_INVALID_STORE_ID O campo STORE_ID deve ser numérico.
INVALID_EXTERNAL_STORE_ID O 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 campo EXTERNAL STORE_ID não se refere a uma loja existente.
INVALID_EXTERNAL_ID O EXTERNAL_ID deve ser alfanumérico, apenas letras e números. Sem espaços ou hífens ou caracteres especiais.
EXTERNAL_ID_TOO_LONG O campo EXTERNAL_ID deve ter menos de 40 caracteres.
INVALID_URL O URL deve ser String e ter o formato de um URL válido.
URL_TOO_LONG O campo URL deve ter menos de 40 caracteres.
FIXED_AMOUNT_FALSE Se o campo URL for indicado, o campo FIXED_AMOUNT deve ser true.
403 FORBIDDEN
1 Se 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.
404 NOT_FOUND
1 Se o caixa não existir para um ID indicado ou EXTERNAL_ID e usuário.
409 CONFLICT
1 Uma caixa com o mesmo EXTERNAL_ID já existe.

La búsqueda no arrojó ningún resultado.

Verifica la la ortografía de los términos de búsqueda o prueba con otras palabras clave.