Crear caja - Cajas - Mercado Pago Developers
¿Qué documentación quieres buscar?

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

Accede a los primeros pasos
Crear caja

POST

https://api.mercadopago.com/pos
Este endpoint permite la creación de una caja (punto de venta) en una tienda para recibir las ventas de productos o servicios. Cada caja tendrá un código QR exclusivo vinculado a ella.
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: Gastronomía
621102: Argentina
5611203: Brasil
Ver más
external_id
string
Identificador único de la caja definido por el integrador.
external_store_id
string
El identificador único de la tienda, establecido por el sistema integrador y puede contener hasta 60 caracteres.
fixed_amount
boolean
Determina si el cliente puede insertar el monto a pagar.
Parámetros de respuesta
id
number
ID de creación del punto de venta. Al registrar un punto de venta, recibirás un ID correspondiente. Este ID puede ser utilizado para varias operaciones, incluida la consulta de los datos del punto de venta.
qr
object
Código QR creado automáticamente para recibir los pagos del punto de venta.
status
string
Status de creación del punto de venta.
date_created
string
Fecha de creación de la caja. Este campo muestra la fecha y hora en el formato ISO 8601, como 2024-08-08T19:29:45.019Z.
Errores

400Error

MISSING_BODY

El cuerpo del HTTP es requerido para modificar el punto de venta.

UNKNOWN_FIELD_EXCEPTION

El campo indicado no está permitido para esta operación o es desconocido.

INVALID_POS_ID

El ID del punto de venta es inválida, debe ser numérica.

INVALID_NAME

NOMBRE debe ser string.

NAME_TOO_LONG

NAME debe ser menor de 45 caracteres.

INVALID_FIXED_AMOUNT

FIXED_AMOUNT debe ser boolean.

INVALID_CATEGORY

CATEGORY debe ser numérico.

POS_UNKNOWN_MCC

CATEGORY debe ser válida para el sitio del usuario.

POS_INVALID_STORE_ID

STORE_ID debe ser numérico.

INVALID_EXTERNAL_STORE_ID

EXTERNAL_STORE_ID debe ser string.

EXTERNAL_STORE_ID_NOT_MATCH

El EXTERNAL_STORE_ID no hace referencia al STORE_ID indicado.

INEXISTENT_EXTERNAL_STORE_ID

El EXTERNAL_STORE_ID no hace referencia a una tienda existente.

INVALID_EXTERNAL_ID

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

EXTERNAL_ID_TOO_LONG

El EXTERNAL_ID debe ser menor de 40 caracteres.

INVALID_URL

La URL debe ser una cadena y debe tener el formato de una URL válida.

URL_TOO_LONG

La URL debe ser menor de 300 caracteres.

FIXED_AMOUNT_FALSE

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

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

Si el punto de venta no existe para el ID o EXTERNAL_ID indicado y para el usuario.

409Error

1

Ya existe un punto de venta con el mismo EXTERNAL_ID.

Solicitud
curl -X POST \
    'https://api.mercadopago.com/pos'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-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-25T15:16: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"
}