/pos

BASE URI https://api.mercadopago.com/pos

HTTP Request

curl 

 curl -X POST \
  'https://api.mercadopago.com/pos' \
  -H 'Authorization: Bearer PROD_ACCESS_TOKEN' \
  -d '{
    "name":"Caja Principal", 
    "fixed_amount": true,
    "category": 621102,
    "store_id": "123456",
    "external_store_id": "BK021",
    "external_id": "4lph4num3r1c",
    "url": "https://www.miempresa.com/MP?locationId=6232&positionId=01" 
}'

Request Params

ParameterTypeDescription
name String Nombre de la caja. (Obligatorio)
fixed_amount Boolean Determina si el cliente puede insertar el monto a pagar. (Obligatorio)
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 categoría genérica.
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 External_id de la sucursal a la cual pertenece la caja, definido por el integrador. (Obligatorio)
external_id String Identificador único de la caja definido por el integrador.
url String URL para obtener la orden del sistema integrador. Es opcional y se utiliza solo 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 Principal",
    "fixed_amount": true,
    "category": 621102,
    "store_id": "12345678",
    "external_store_id": "BK021",
    "url": "https://www.miempresa.com/MP?locationId=6232&positionId=01",
    "external_id": "4lph4num3r1c"
}

Error Codes

CodeDescription
400 BAD_REQUEST
MISSING_BODY El body HTTP es requerido para crear cajas.
UNKNOWN_FIELD_EXCEPTION El campo indicado no se permite para esta operación o es desconocido.
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.
UNKNOWN_MCC El campo CATEGORY debe ser uno válido para el site del usuario.
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 ningún 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.