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. En caso de éxito, la solicitud devolverá una respuesta con el estado 201.
POST
REQUERIDO
REQUERIDO
REQUERIDO CONDICIONAL
id. Solo se permiten dígitos. El límite máximo perREQUERIDO CONDICIONAL
external_id. El límite máximo permitido es de 60 caracteres. Obligatorio si store_id no es enviadoactive (el punto de venta está activo y disponible para recibir pagos) e inactive (el punto de venta está inactivo y no puede recibir pagos).400Solicitud incorrecta
bad_request
La solicitud no pudo procesarse. Verifica que el body cumpla el JSON schema, que al menos uno de los campos store_id o external_store_id esté presente (si no se envía ninguno, el detalle del error será: one of 'store_id' or 'external_store_id' is required), que el header X-Idempotency-Key esté presente y no vacío, y que el dominio de la URL en el config esté registrado y activo como integrador.
idempotency_key_already_used
El valor de X-Idempotency-Key enviado ya fue utilizado en una solicitud anterior con un payload diferente. Genera un nuevo valor único para cada operación distinta.
bad_request_url_format
El valor de config.qr.url no cumple con el formato esperado. La URL debe comenzar con https://. Ejemplo de detalle del error: config.qr.url does not meet the expected format. Please refer to the documentation for guidance.
invalid_external_store_id
El external_store_id enviado no corresponde a la sucursal identificada por store_id. Cuando se envían ambos, deben corresponder a la misma sucursal.
401No autorizado
unauthorized
El valor enviado como Access Token es incorrecto o está ausente. Por favor, verifícalo e intenta nuevamente con un Access Token válido.
404No encontrado
store_not_found
La tienda identificada por store_id o external_store_id no existe o no pertenece al usuario del Access Token. Verifica que la tienda exista y esté asociada a tu cuenta.
409Conflicto
pos_already_exists
Ya existe un punto de venta con el mismo external_id para este usuario. El external_id debe ser único por caja del usuario.
conflict
La misma solicitud ya está siendo procesada por otra llamada concurrente con el mismo X-Idempotency-Key. Espera unos segundos y reintenta con la misma clave y el mismo payload.
422Entidad no procesable
unprocessable_entity
No se pudo resolver la identificación del usuario a partir del Access Token. Verifica que el token sea válido y esté asociado a una cuenta activa de Mercado Pago.
424Fallo de dependencia
internal_error_check_store_owner
Ocurrió un error de comunicación al validar la titularidad de la tienda. Se trata de una falla de dependencia y no está relacionada con los datos de la solicitud. Por favor, vuelve a intentarlo.
500Error interno del servidor
internal_server_error
Ocurrió un error inesperado en el servidor. Se trata de una falla transitoria no relacionada con los datos de la solicitud. Por favor, vuelve a intentarlo después de unos momentos.
curl -X POST \
'https://api.mercadopago.com/v2/pos'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
-H 'X-Idempotency-Key: 5197d887-fbbc-419a-b37a-13a0ad14e665' \
-d '{
"name": "POS-001",
"store_id": "987654",
"external_id": "SUC001POS001",
"config": {
"qr": {
"operating_mode": "pdv",
"category": 621102,
"url": "https://integrator.example.com/qr/order"
}
}
}'{
"id": 1234567,
"name": "POS-001",
"status": "active",
"date_created": "2024-01-15T10:30:00Z",
"date_last_updated": "2024-03-01T08:00:00Z",
"user_id": 123456,
"store_id": "987654",
"external_id": "SUC001POS001",
"config": {
"qr": {
"operating_mode": "pdv"
}
},
"qr_response": {
"uuid": "0977011a027c4b4387e52069da4264deae2946af4dcc44ee98a8f1dbb376c8a1",
"image": "https://www.mercadopago.com/instore/merchant/qr/1234567/abc123.png",
"template_document": "https://www.mercadopago.com/instore/merchant/qr/1234567/template_abc123.pdf",
"template_image": "https://www.mercadopago.com/instore/merchant/qr/1234567/template_abc123.png",
"qr_code": "00020101021226940014BR.GOV.BCB.PIX2572pix-qr-h.mercadopago.com/instore/h/p/v2/abc123"
}
}