Crear una Caja - Cajas - Mercado Pago Developers

Crear una Caja

POST

/pos

Genera un punto de venta en una sucursal. Cada caja tendrá vinculado un código QR unívoco.

Localización: bodyCódigo MCC que indica el rubro del Punto de Venta. Si no se especifica, queda como categoría 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

Localización: bodyIdentificador único de la caja definido por el integrador

Localización: bodyExternal_id de la sucursal a la cual pertenece la caja, definido por el integrador

Localización: bodyDetermina si el cliente puede insertar el monto a pagar

Localización: bodyid

Localización: bodyqr

Localización: bodystatus

Localización: bodydate_created

curl -X POST \
    'https://api.mercadopago.com/pos' \
    -H 'Authorization: Bearer ACCESS_TOKEN_ENV' \ 
    -d '{
  "name": "First POS",
  "fixed_amount": false,
  "store_id": 1234567,
  "external_store_id": "SUC001",
  "external_id": "SUC001POS001",
  "category": 621102
}'

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

400bad_request

MISSING_BODYEl body HTTP es requerido para crear cajas.

UNKNOWN_FIELD_EXCEPTIONEl campo indicado no se permite para esta operación o es desconocido.

INVALID_NAMENombre inválido. Debe ser String.

NAME_TOO_LONGEl NAME debe ser menor a 45 caracteres.

INVALID_FIXED_AMOUNTEl campo FIXED_AMOUNT debe ser Boolean.

INVALID_CATEGORYEl campo CATEGORY debe ser numérico.

UNKNOWN_MCCEl campo CATEGORY debe ser uno válido para el site del usuario.

INVALID_STORE_IDEl campo STORE_ID debe ser numérico.

INVALID_EXTERNAL_STORE_IDEXTERNAL_STORE_ID muste be string

EXTERNAL_STORE_ID_NOT_MATCHEl campo EXTERNAL_STORE_ID no hace referencia al STORE_ID indicado.

INEXISTENT_EXTERNAL_STORE_IDEl campo EXTERNAL_STORE_ID no hace referencia a ningún sucursal existente.

INVALID_EXTERNAL_IDEl campo EXTERNAL_ID debe ser alfanumérico, solo letras y números. Sin espacios ni guiones, ni caracteres especiales.

EXTERNAL_ID_TOO_LONGEl campo EXTERNAL_ID debe ser menor a 40 caracteres.

INVALID_URLThe URL must be string and muste have the format of a valid url

URL_TOO_LONGEl campo URL debe ser menor a 300 caracteres.

FIXED_AMOUNT_FALSESi se indica el campo URL, el campo FIXED_AMOUNT debe ser true. No soportamos la modalidad de monto abierto en este caso.

403bad_request

1Si 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.

404bad_request

1Si no existe el POS para un ID o EXTERNAL_ID y user indicados.

409bad_request

1Ya existe una caja con el mismo EXTERNAL_ID.

¿Te resultó útil esta información?