Create store and POS - Integration stages - Mercado Pago Developers
Create store and POS
After setting up the environment of the debug terminal to receive your SmartApp, integrating and testing the payment flow of our SDK, you will need to create the stores and points of sale (POS) that will be responsible for the operation of these terminals before submitting your application for validation and distribution on the terminals.
A store represents a physical store within Mercado Pago, which can have one or more associated points of sale. However, each point of sale only allows one associated terminal. This means that if you want to integrate more than one terminal, you must create the same number of points of sale and perform their association individually.
The creation and subsequent configuration of stores and points of sale can be done through two ways: through the Mercado Pago panel, or via API. The latter option is useful for systems that need to operate with multiple points of sale, as it allows associating multiple stores from the integrating system.
It is possible to create stores and points of sale from your system through our APIs for in-person payments. To do this, follow the steps below.
To create a store via API, send a POST with the Access Token that corresponds to your integration type (for your own terminal integrationMercado Pago Point integrations to your system for your own use and configured using your application's production credentials. For more information, access the link below.Access credentials or for a third-part integrationMercado Pago Point integrations to your system on behalf of a seller and configured using credentials obtained through the OAuth security protocol. For more information, access the link below.) to the endpoint Create storeAPI. You must add the user_id of the Mercado Pago account that will receive the money from the transactions in the path of your request and complete the required parameters with the business details as indicated below.
It is essential to correctly fill in all store location information (city_name, state_name, latitude and longitude). Incorrect data can cause errors in tax calculations, directly impacting billing and fiscal compliance of your company.
Identifier of the Mercado Pago account that receives the money for sales made at the store. If you are performing your for your own terminal integrationMercado Pago Point integrations to your system for your own use and configured using your application's production credentials. For more information, access the link below.Access credentials integration, you will find this value in the Application details. If, on the other hand, you are performing an integration for a third-part integrationMercado Pago Point integrations to your system on behalf of a seller and configured using credentials obtained through the OAuth security protocol. For more information, access the link below.Access credentials, you will obtain the value in the response to the linking through OAuthPrivate key generated through the OAuth security protocol, which allows managing integrations on behalf of third parties. For more information, go to the documentation.OAuth.
name
Required
Name of the created store.
external_id
Optional
External identifier of the store for the integrator's system. It can contain any alphanumeric value up to 60 characters, and must be unique for each store. For example, SUCMercadoPago.
location
Required
This object must contain all data relating to the store location. You must pay particular attention to completing them correctly with the simple decimal standard, especially the latitude and longitude parameters, with the real data of the physical location. For example, "latitude": 27.175193925922862, and "longitude": 78.04213533235064 correspond to the exact location of the Taj Mahal, in India.
If the request was sent correctly, the response will look like the example below.
In addition to the data sent in the request, it will return the identifier assigned to that store by Mercado Pago under the id parameter.
Creating stores and points of sale through the Mercado Pago Panel is the option for those who only need to manage one point of sale and prefer to simplify the process. To do this, log into your Mercado Pago account, and follow the instructions below.
In the left side menu, go to Your business > Stores and points of sale.
In the "Store list" section, click the + Add store button.
Complete the Name and Address of your new store, optionally add Extra data, if you need more detail, and click Continue.
Complete the required information with the store operating hours, selecting the days and opening hours. When finished, click Continue.
The options available on this screen adapt to multiple scenarios. It will allow you to select a single schedule for all days of the week, or a different schedule for each one, along with the possibility of entering special schedules for holidays. Choose the option that best suits your store.
Next, you will be on the screen to create points of sale associated with the store, where you must assign a Name. If you wish, you can create more than one point of sale.
Remember that it is only possible to configure one terminal per point of sale. If you want to integrate multiple terminals, you must create a point of sale for each one of them.
Click the Continue button, and you're done! You have created and configured your store and your point of sale.
The IDs returned (store_id and pos_id) after creating the stores and POS must be provided to your Mercado Pago representative. This will allow you to proceed with the SmartApp deployment process.