Create store and cash register

After creating the application and obtaining the credentials, it is necessary to configure the store and cash register, which will be associated with transactions.

Stores represent physical establishments registered in Mercado Pago and can have one or more cash registers linked. Cash registers correspond to points of sale (POS) and must always be associated with a store, ensuring reconciliation of QR Code payments in physical establishments.

It is possible to create stores and cash registers from your system through our APIs for in-person payments. To do this, follow the steps below.

Create store

To create a store via API, send a POST with the test Access TokenPrivate key of the application created in Mercado Pago, used in the backend during integration development. You can access it in Your integrations > Integration data > Tests > Test credentials. When going to production, replace it with the production Access Token if it is your own integration, or with the Access Token obtained via OAuth in the case of third-party integrations. The test Access Token starts with the prefix `APP_USR`.Access test credentials to the endpoint Create storeAPI. You must add the test account user_idDuring development, use the User ID from the test account. Go to Your integrations > Integration data > Test credentials > Test credentials data and copy the displayed User ID. When going to production, replace it with the User ID from the real Mercado Pago account that will receive the payments. in the path of your request and complete the required parameters with the business details as indicated below.

curl
curl -X POST \
    'https://api.mercadopago.com/users/USER_ID/stores'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer ACCESS_TOKEN' \
    -d '{
  "name": "Instore Shop",
  "business_hours": {
    "monday": [
      {
        "open": "08:00",
        "close": "12:00"
      }
    ],
    "tuesday": [
      {
        "open": "09:00",
        "close": "18:00"
      }
    ]
  },
  "external_id": "SHOP001",
  "location": {
    "street_number": "0123",
    "street_name": "Example street name.",
    "city_name": "City name.",
    "state_name": "State name.",
    "latitude": 27.175193925922862,
    "longitude": 78.04213533235064,
    "reference": "Near Mercado Pago."
  }
}'

If the request was sent correctly, the response will be as the following example:

json
{
  "id": 1234567,
  "name": "Instore Shop",
  "date_created": "2019-08-08T19:29:45.019Z",
  "business_hours": {
    "monday": [
      {
        "open": "08:00",
        "close": "12:00"
      }
    ],
    "tuesday": [
      {
        "open": "09:00",
        "close": "18:00"
      }
    ]
  },
  "location": {
    "address_line": "Example street name, 0123, City name, State name.",
    "latitude": 27.175193925922862,
    "longitude": 78.04213533235064,
    "reference": "Near Mercado Pago"
  },
  "external_id": "SHOP001"
}

In addition to the data sent in the request, the endpoint will return the identifier assigned to the store by Mercado Pago under the id parameter.

Create cash register

To enable sales with Mercado Pago, it is essential that each registered store has at least one cash register linked. To create a cash register and associate it with the previously created store, send a POST including your test Access TokenPrivate key of the application created in Mercado Pago, used in the backend. You can access it in Your integrations > Integration data > Tests > Test credentials. During the integration process, use the test Access Token. Upon completing the integration, replace it with the production Access Token if it is your own integration, or with the Access Token obtained via OAuth for third-party integrations. The test Access Token starts with the prefix `APP_USR`.Access test credentials to the endpoint Create cash registerAPI as shown below.

curl
curl -X POST \
    'https://api.mercadopago.com/v2/pos'\
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer ACCESS_TOKEN' \
    -H 'X-Idempotency-Key: UNIQUE_KEY' \
    -d '{
  "name": "POS-001",
  "store_id": "1234567",
  "external_id": "SHOP001POS001",
  "config": {
    "qr": {
      "operating_mode": "pdv"
    }
  }
}'

If the request was sent correctly, the response will be as the following example.

json
{
  "id": 1234567,
  "name": "POS-001",
  "status": "active",
  "date_created": "2024-01-15T10:30:00Z",
  "date_last_updated": "2024-01-15T10:30:00Z",
  "user_id": 123456,
  "store_id": "1234567",
  "external_store_id": "SHOP001",
  "external_id": "SHOP001POS001",
  "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"
  }
}

See in the table below the description of some of the returned parameters that may be useful to continue with your integration later.

If both requests were successful, you will have created and configured the store and cash register necessary for QR Code integration.

With the store and cash register created, you can integrate payment processing.