Crear caja - Cajas - Mercado Pago Developers
Crear caja

POST

/pos
Genera un punto de venta en una sucursal. Cada caja tendrá vinculado un código QR unívoco.
Parámetros para la solicitud
category
number
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
external_id
string
Localización: bodyIdentificador único de la caja definido por el integrador
external_store_id
string
Localización: bodyExternal_id of the store to which the pos belongs defined by integrator system.
fixed_amount
boolean
Localización: bodyDetermina si el cliente puede insertar el monto a pagar
Parámetros de respuesta
id
number
Localización: bodyid
qr
object
Localización: bodyqr
status
string
Localización: bodystatus
date_created
string
Localización: bodydate_created
Solicitud
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
}'
Respuesta
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"
}
Errores
400bad_request
MISSING_BODYHTTP body is required to create pos.
UNKNOWN_FIELD_EXCEPTIONThe indicated field is not allowed for this operation or is unknown.
INVALID_NAMENAME must be string.
NAME_TOO_LONGThe NAME must be less than 45 characters.
INVALID_FIXED_AMOUNTFIXED_AMOUNT must be boolean.
INVALID_CATEGORYCATEGORY must be numeric.
UNKNOWN_MCCThe CATEGORY must be valid for the user's site.
INVALID_STORE_IDSTORE_ID must be numeric.
INVALID_EXTERNAL_STORE_IDEXTERNAL_STORE_ID muste be string.
EXTERNAL_STORE_ID_NOT_MATCHThe EXTERNAL_STORE_ID does not refer to the indicated STORE_ID.
INEXISTENT_EXTERNAL_STORE_IDThe EXTERNAL_STORE_ID does not refer to any existing store.
INVALID_EXTERNAL_IDThe EXTERNAL_ID field must be alphanumeric, only letters and numbers. No spaces or hyphens, or special characters.
EXTERNAL_ID_TOO_LONGThe EXTERNAL_ID must be less than 40 characters.
INVALID_URLThe URL must be string and muste have the format of a valid url
URL_TOO_LONGThe URL must be less than 300 characters.
FIXED_AMOUNT_FALSEIf the URL field is indicated, the FIXED_AMOUNT field must be true. We do not support the open amount modality in this case.
403bad_request
1If you are using the URL field, the host must be enabled by Mercado Pago. If it is not, you will receive this error. Please contact your assigned technical advisor.
404bad_request
1If the POS does not exist for an indicated ID or EXTERNAL_ID and user.
409bad_request
1A pos with the same EXTERNAL_ID already exists.