Inicio
Documentación
Recursos
Certificaciones
Comunidad

Recursos

Revisa las actualizaciones de nuestras soluciones y operatividad del sistema o pide soporte técnico.

Comunidad

Recibe las últimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Crear caja - Cajas - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

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
name
string
Nombre del punto de venta.
fixed_amount
boolean
Determina si el cliente puede insertar el monto a pagar.
store_id
string
Identificador de la sucursal a la que pertenece el punto de venta.
external_store_id
string
El identificador único de la tienda, establecido por el sistema integrador y puede contener hasta 60 caracteres.
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.

non_existent_external_store_id

El External Store ID no se refiere a ninguna tienda.

409Error

point_of_sale_exists

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 '{
  "name": "First POS",
  "fixed_amount": false,
  "store_id": 1234567,
  "external_store_id": "SUC001",
  "external_id": "SUC001POS001",
  "category": 621102
}'
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"
}