Home
Documentation
Resources
Partners
Community

Resources

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

Partners

Discover our program for agencies or developers that offer integration services and sellers who want to hire them.

Community

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

Create POS - Points of Sale - Mercado Pago Developers

Intelligent search powered by OpenAI 

Create point of sale

POST

https://api.mercadopago.com/pos
This endpoint allows for the creation of a point of sale in a store to receive payments for products or services. Each point of sale will have a unique QR code linked to it.
Request's parameters
BODY
name
string
Name of the point of sale.
fixed_amount
boolean
Define if the customer can insert the amount to be paid.
store_id
string
Store identifier to which the point of sale belongs.
external_store_id
string
The unique store identifier, set by the integrated system and can contain up to 60 characters.
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 creation.
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.

non_existent_external_store_id

External Store ID does not refer any store.

409Error

point_of_sale_exists

A point of sale with the same EXTERNAL_ID already exists.

Request
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
}'
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": "SUC001POS001"
}