Home
Documentation
Resources
Certifications
Community

Resources

Check for updates on our solutions and system performance, or request technical support.

Community

Get the latest news, ask others for help and share your knowledge.

Update POS - Points of Sale - Mercado Pago Developers

Intelligent search powered by OpenAI 

Update point of sale

PUT

https://api.mercadopago.com/pos/{id}
This endpoint allows you to update the data of a point of sale. To use it, you need to provide the identification of the point of sale and send the parameters with the information to be updated.
Request's parameters
PATH
id
string

REQUIRED

Creation ID of the point of sale. When you register a point of sale, you will receive a corresponding ID. This ID can be used for various operations, including updating the point of sale data.
BODY
name
string
Name of the point of sale.
fixed_amount
boolean
Define if the customer can insert the amount to be paid.
category
number
MCC code that indicates the category of the point of sale. If not specified, it remains as a generic category
Gastronomy: Gastronomy
621102: Argentina
5611203: Brazil
View more
store_id
string
Store identifier to which the point of sale belongs.
Response parameters
id
number
Creation ID of the point of sale. When you register a point of sale, you will receive a corresponding ID. This ID can be used for various operations, including retrieving the point of sale data.
qr
object
QR code automatically created to receive payments from the point of sale.
status
string
Status of the point of sale data update.
date_created
string
Point of sale creation date. This field displays the date and time in ISO 8601 format, such as 2024-08-08T19:29:45.019Z.
Errors

400Error

MISSING_BODY

HTTP body is required to modify point of sale.

UNKNOWN_FIELD_EXCEPTION

The indicated field is not allowed for this operation or is unknown.

INVALID_POS_ID

The ID of the point of sale is invalid, it must be numeric.

INVALID_NAME

NAME must be string.

NAME_TOO_LONG

The NAME must be less than 45 characters.

INVALID_FIXED_AMOUNT

FIXED_AMOUNT must be boolean.

INVALID_CATEGORY

CATEGORY must be numeric.

POS_UNKNOWN_MCC

CATEGORY must be valid for the user's site.

POS_INVALID_STORE_ID

STORE_ID must be numeric.

INVALID_EXTERNAL_STORE_ID

EXTERNAL_STORE_ID must be string.

EXTERNAL_STORE_ID_NOT_MATCH

The EXTERNAL_STORE_ID does not refer to the indicated STORE_ID.

INEXISTENT_EXTERNAL_STORE_ID

The EXTERNAL STORE_ID does not refer to an existing Store.

INVALID_EXTERNAL_ID

The EXTERNAL_ID field must be alphanumeric, only letters and numbers. No spaces, hyphens or special characters.

EXTERNAL_ID_TOO_LONG

The EXTERNAL_ID must be less than 40 characters.

INVALID_URL

The URL must be string and muste have the format of a valid url

URL_TOO_LONG

The URL must be less than 300 characters.

FIXED_AMOUNT_FALSE

If the URL field is indicated, the FIXED_AMOUNT field must be true. We do not support the open amount modality in this case.

403Error

1

If you are using the URL field, the host must be enabled by Mercado Pago. If it is not, you will receive this error. Please contact your assigned technical advisor.

404Error

1

If the point of sale does not exist for an indicated ID or EXTERNAL_ID and to the user.

409Error

1

A pont of sale with the same EXTERNAL_ID already exists.

Request
curl -X PUT \
    'https://api.mercadopago.com/pos/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-3322*********190-03031*********46528954c*********0339910-1*********' \
    -d '{
  "name": "First POS",
  "fixed_amount": false,
  "category": 621102,
  "store_id": 1234567,
  "external_id": "SUC001POS001",
  "external_store_id": "SUC001"
}'
Sample answer
{
  "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": "SUC001POS002",
  "site": "MLB",
  "qr_code": "00020101021226940014BR.GOV.BCB.PIX2572pix-qr-h.mercadopago.com/instore/h/p/v2/db12b6e2ec4844839825c6dce7cd2f2243530016com.mercadolibre0129https://mpago.la/pos/212798995204000053039865802BR5924VICTOR CORREA DE ALMEIDA6008CAMPINAS62070503***63040B44"
}