Inicio
DocumentaciĂłn
Recursos
Partners
Comunidad

Recursos

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

Partners

Conoce nuestro programa para agencias o desarrolladores que ofrecen servicios de integraciĂłn y vendedores que quieren contratarlos.

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-7434*********159-03141*********cee51edf8*********f94f589-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"
}