Este endpoint permite actualizar los datos de una caja (punto de venta). Para utilizarlo, proporciona el ID del punto de venta y envía solo los parámetros que deseas actualizar. Todos los campos son opcionales. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.
PATCH
REQUERIDO
REQUERIDO
REQUERIDO
REQUERIDO CONDICIONAL
id. Solo se permiten dígitosREQUERIDO CONDICIONAL
external_id. Obligatorio si `store_active (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, el punto de venta pertenezca al usuario del Access Token, el header X-Idempotency-Key esté presente y no vacío, y el dominio de la URL en el config esté registrado y activo como integrador.
resource_bad_request_error
El pos_id proporcionado en el path no es un entero válido o es negativo. Verifica que el valor sea un entero base-10 no negativo.
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.
invalid_operating_mode
El valor enviado para config.qr.operating_mode no es válido. Los valores aceptados son: self_service, unattended, pdv, standalone.
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
pos_not_found
No se encontró ningún punto de venta para el pos_id proporcionado y el usuario del Access Token. Verifica que el ID sea correcto y pertenezca a tu cuenta.
store_not_found
La tienda identificada por store_id o external_store_id no existe o no pertenece al usuario del Access Token.
409Conflicto
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.
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 PATCH \
'https://api.mercadopago.com/v2/pos/{pos_id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
-H 'X-Idempotency-Key: 9dd4ba00-8ae3-4c7f-8394-fde6b219bcc3' \
-d '{
"name": "POS-001",
"store_id": "987654",
"external_id": "SUC001POS002",
"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,
"external_id": "SUC001POS002",
"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"
}
}