Suggest edit
Help us improve the documentation
Did you see wrong information and would you like us to explain something else or improve our manuals? Please leave your suggestions on GitHub.

Stores and POS

Introduction

Stores and Points of Sale are the concepts you’ll use on Mercado Pago to manage your business and keep track of your accounts. You can have several POS in one Store.

Term Description
Store A physical shop in which your clients can get products and services. You can have multiple stores on one account.
POS A place to execute a transaction on a store or physical shop. Each POS will be linked with a unique QR code.

Cajas y Sucursales

Stores

What are the benefits of creating stores?

  • Tracking. Each pay will be linked with a store. This will be useful to obtain reconciliation reports and identify transactions per store.
  • Map Visibility. Stores will appear on Mercado Pago and Mercado Libre maps, so user will be able to find you.
  • Better organization for your POS.

How to create a store

To create a store, is importante to declare name, working hours, location and an identifier.

Run the next code to generate a store:

curl -X POST https://api.mercadopago.com/users/$COLLECTOR_ID/stores?access_token=PROD_ACCESS_TOKEN -d
{  
   "name":"Store 1",
   "business_hours":{  
      "monday":[  
         {  
            "open":"08:00",
            "close":"13:00"
         },
         {  
            "open":"15:00",
            "close":"18:00"
         }
      ],
      "tuesday":[  
         {  
            "open":"08:00",
            "close":"18:00"
         }
      ]   
   },
   "location":{  
      "street_number":"3039",
      "street_name":"Caseros",
      "city_name":"Belgrano",
      "state_name":"Capital Federal",
      "latitude":-32.8897322,
      "longitude":-68.8443275,
      "reference":"3er Piso"
   },
   "external_id":"STORE001"
}

Learn more with our API reference.

Point of Sale (POS)

Once you created your stores, the next step is to generate your POS. Some considerations:

Term Description
EXTERNAL_STORE_ID Links a Point of Sale (POS) to a store. This is a required field and same as the Store external_id previously created.
EXTERNAL_ID Identifies each Point of Sale (POS). This is required and can’t be modified nor repeated on the same Mercado Pago account.
URL Will only be used in the Unattended model. On this field you’ll declare your web address, to which Mercado Pago will later make requests for available orders.
curl -X POST https://api.mercadopago.com/pos?access_token=PROD_ACCESS_TOKEN -d     
{
  "name":"Main Pos", 
  "fixed_amount": true,
  "category": 621102,
  "external_store_id": "STORE001",
  "external_id": "POS0001",
  "url": "https://www.miempresa.com/pay-mp?locationId=6232&positionId=1"
}

Learn more with our API Reference.

Once Point of Sale is created, you’ll be able to see the QR files in the “Response” section, along with other relevant data.

Next steps

Integrate QR attended modelRECOMMENDED

Check this if your selling process needs an operator.

Integrate QR unattended modelRECOMMENDED

If your selling process only needs a client action, this is the model for you.








La búsqueda no arrojó ningún resultado.

Verifica la la ortografía de los términos de búsqueda o prueba con otras palabras clave.