/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 único de la caja, numérico y autogenerado.
name String Nombre de la caja.
fixed_amount Boolean Determina si el cliente puede insertar el monto a pagar.
true El cliente no podrá elegir el monto a pagar sino que deberá esperar la generación de una orden.
false Luego de escanear el código QR de la caja, el cliente ingresa el monto a pagar.
category Long Código MCC que indica el rubro del Punto de Venta. Si no se especifica, queda como categoria generica.
Argentina Gastronomía - 621102
Petrolera - 473000
Brasil Gastronomía - 5611203
Petrolera - 4731300
Mexico Gastronomía - 5812
Petrolera - 468419
Colombia Gastronomía - 5611
Petrolera - 4731
Peru Gastronomía - 5520
Petrolera - 5050
Uruguay Gastronomía - 56101
Petrolera - 47300
Chile Gastronomía - 561000
Petrolera - 473001
store_id String Identificador de la sucursal a la que pertenece el Punto de Venta.
external_store_id String Identificador único de la sucursal a la cual pertenece la caja, definido por el integrador.
url String URL para obtener la orden del sistema integrador. Es opcional y se utiliza sólo en el modelo de integración desatendido.

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 El body HTTP es requerido para modificar cajas.
UNKNOWN_FIELD_EXCEPTION El campo indicado no se permite para esta operación o es desconocido.
INVALID_POS_ID El ID de la caja es inválido, tiene que ser numérico.
INVALID_NAME El NAME debe ser String.
NAME_TOO_LONG El NAME debe ser menor a 45 caracteres.
INVALID_FIXED_AMOUNT El campo FIXED_AMOUNT debe ser Boolean.
INVALID_CATEGORY El campo CATEGORY debe ser numérico.
POS_UNKNOWN_MCC El campo CATEGORY debe ser uno válido para el site del usuario.
POS_INVALID_STORE_ID El campo STORE_ID debe ser numérico.
INVALID_EXTERNAL_STORE_ID El campo EXTERNAL_STORE_ID debe ser String.
EXTERNAL_STORE_ID_NOT_MATCH El campo EXTERNAL_STORE_ID no hace referencia al STORE_ID indicado.
INEXISTENT_EXTERNAL_STORE_ID El campo EXTERNAL_STORE_ID no hace referencia a una sucursal existente.
INVALID_EXTERNAL_ID El campo EXTERNAL_ID debe ser alfanumérico, solo letras y números. Sin espacios ni guiones, ni caracteres especiales.
EXTERNAL_ID_TOO_LONG El campo EXTERNAL_ID debe ser menor a 40 caracteres.
INVALID_URL El campo URL debe ser String, y tener el formato de una url válida.
URL_TOO_LONG El campo URL debe ser menor a 300 caracteres.
FIXED_AMOUNT_FALSE Si se indica el campo URL, el campo FIXED_AMOUNT debe ser true. No soportamos la modalidad de monto abierto en este caso.
403 FORBIDDEN
1 Si estás usando el campo URL, el host de la misma tiene que estar habilitado por Mercado Pago. Si no lo está, recibirás este error. Por favor contactá a tu asesor técnico asignado.
404 NOT_FOUND
1 Si no existe el POS para un ID o EXTERNAL_ID y user indicados.
409 CONFLICT
1 Ya existe una caja con el mismo EXTERNAL_ID.

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.