This endpoint allows to update the data of a point of sale. To use it, provide the point of sale ID and send only the parameters you want to update. All fields are optional. In case of success, the request will return a response with status 200.
PATCH
REQUIRED
REQUIRED
REQUIRED
CONDITIONALLY REQUIRED
id parameter. Only digits are allowedCONDITIONALLY REQUIRED
external_id parameter. Required if store_id isactive (the point of sale is enabled and available to receive payments) and inactive (the point of sale is disabled and cannot receive payments).400Bad request
bad_request
The request could not be processed. Verify that the body complies with the JSON schema, the point of sale belongs to the Access Token user, the X-Idempotency-Key header is present and not empty, and the URL domain in the config is registered and active as an integrator.
resource_bad_request_error
The pos_id provided in the path is not a valid integer or is negative. Verify that the value is a non-negative base-10 integer.
idempotency_key_already_used
The X-Idempotency-Key value sent was already used in a previous request with a different payload. Generate a new unique value for each distinct operation.
invalid_operating_mode
The value sent for config.qr.operating_mode is not valid. Accepted values are: self_service, unattended, pdv, standalone.
401Unauthorized
unauthorized
The value sent as Access Token is incorrect or missing. Please check and try again with a valid Access Token.
404Not found
pos_not_found
No point of sale was found for the provided pos_id and the Access Token user. Verify that the ID is correct and belongs to your account.
store_not_found
The store identified by store_id or external_store_id does not exist or does not belong to the Access Token user.
409Conflict
conflict
The same request is already being processed by another concurrent call with the same X-Idempotency-Key. Wait a few seconds and retry with the same key and the same payload.
424Failed dependency
internal_error_check_store_owner
A communication error occurred while validating store ownership. This is a dependency failure and not related to the request data. Please try again.
500Internal server error
internal_server_error
An unexpected error occurred on the server. This is a transient failure not related to the request data. Please try again after a few moments.
curl -X PATCH \
'https://api.mercadopago.com/v2/pos/{pos_id}'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-5*********956537-12*********ff1a3d36d*********47e7b9985*********770' \
-H 'X-Idempotency-Key: 5c727f12-5280-49bd-b5f9-4272fec112c8' \
-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"
}
}