Crear caja - Cajas - Mercado Pago Developers
¿Qué estás buscando?

¿No sabes cómo empezar la integración? 

Accede a los primeros pasos
Crear caja

POST

https://api.mercadopago.com/pos
Genera un punto de venta en una sucursal. Cada caja tendrá vinculado un código QR unívoco.
Parámetros para la solicitud
BODY
category
number
Có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
Ver más
external_id
string
Identificador único de la caja definido por el integrador
external_store_id
string
External_id of the store to which the pos belongs defined by integrator system.
fixed_amount
boolean
Determina si el cliente puede insertar el monto a pagar
Parámetros de respuesta
id
number
id
qr
object
qr
status
string
status
date_created
string
date_created
Errores

400Error

MISSING_BODY

HTTP body is required to create pos.

UNKNOWN_FIELD_EXCEPTION

The indicated field is not allowed for this operation or is unknown.

INVALID_NAME

NAME must be string.

NAME_TOO_LONG

The NAME must be less than 45 characters.

INVALID_FIXED_AMOUNT

FIXED_AMOUNT must be boolean.

INVALID_CATEGORY

CATEGORY must be numeric.

UNKNOWN_MCC

The CATEGORY must be valid for the user's site.

INVALID_STORE_ID

STORE_ID must be numeric.

INVALID_EXTERNAL_STORE_ID

EXTERNAL_STORE_ID muste be string.

EXTERNAL_STORE_ID_NOT_MATCH

The EXTERNAL_STORE_ID does not refer to the indicated STORE_ID.

INEXISTENT_EXTERNAL_STORE_ID

The EXTERNAL_STORE_ID does not refer to any existing store.

INVALID_EXTERNAL_ID

The EXTERNAL_ID field must be alphanumeric, only letters and numbers. No spaces or hyphens, or special characters.

EXTERNAL_ID_TOO_LONG

The EXTERNAL_ID must be less than 40 characters.

INVALID_URL

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

URL_TOO_LONG

The URL must be less than 300 characters.

FIXED_AMOUNT_FALSE

If the URL field is indicated, the FIXED_AMOUNT field must be true. We do not support the open amount modality in this case.

403Error

1

If 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.

404Error

1

If the POS does not exist for an indicated ID or EXTERNAL_ID and user.

409Error

1

A pos with the same EXTERNAL_ID already exists.

Solicitud
curl -X POST \
    'https://api.mercadopago.com/pos'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-7719*********832-03141*********ec9309854*********f1e54b5-1*********' \
    -d '{
  "category": 621102,
  "external_id": "SUC001POS001",
  "external_store_id": "SUC001",
  "fixed_amount": false,
  "name": "First POS",
  "store_id": 1234567
}'
Respuesta de ejemplo
{
  "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"
}