Configure your device in Point of Sale mode

Important

Before configuring the Point device in Point of Sale mode, you must access your Mercado Pago account and have created an application with PointdeMercadoPago as the product to integrate.

Also, remember to access your production credentials to manage your integration correctly.

To start your integration with Mercado Pago Point via API, you must configure your device in Point of Sale mode. To do this, follow the steps below.

Create a store and a POS

To configure the Point device in Point of Sale mode, you must associate it with a store and a point of sale in this store.

If you haven't created any stores or POS yet, you can do so through our API.

First, you must create a store using the endpoint Create store. You must replace the values user_id and YOUR_ACCESS_TOKEN with the ones obtained when creating your application, as well as modify the necessary parameters according to your business characteristics.

Then, you must create a POS using the endpoint Create POS. This POS must be associated with the store created earlier, so you must replace the parameters external_store_id and store_id with the ones obtained during the store creation. In the case of store_id, the value will correspond to the id returned in that response.

Associate the Point device to your Mercado Pago account

To link the Point device to your Mercado Pago account, you need to have the Mercado Pago app installed on your mobile device.

Sign in to the app with your username and password and tap the QR icon to scan the code that appears when you turn on the Point device. This way, the device will be linked to your account.

If you are going to operate on behalf of other sellers, you can securely manage the linking by integrating OAuth .

Configure your store and POS

Once you have linked your Point device to your Mercado Pago account and have created the store and POS, you must complete the business data and configure the POS to associate them with the device.

To do this, you can access the Mercado Pago site and go to Your business > Stores and registers.

You can also configure the store and POS directly from the Point device once it is linked. The device itself will guide you if you choose to configure it this way.

Activate the POS mode on your Point device

To integrate the Point device with our API, it is necessary to activate the Point of Sale (POS) operating mode.

To activate it for the first time, retrieve the devices through the API Get devices. This call will return a list of devices associated with your Mercado Pago account. You can identify the desired Point device by the last characters of the id field, which should match the serial number displayed on the back label of the device.

Then, make a PATCH request to the endpoint Change operating mode, replacing device-id with the value obtained in that field from the response to the previous GET request.

curl -X PATCH \
      'https://api.mercadopago.com/point/integration-api/devices/{device-id}' \
       --h 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
       -H 'Content-Type: application/json' \ 
      -d '{
  "operating_mode": "PDV"
}'

You will receive a response like this:

{
"operating_mode": "PDV"
}

Important

Please note that only one point-of-sale device is allowed per checkout, and it should only be handled by a store operator. The unattended self-service use of a device is the full responsibility of the merchant. Consider this limitation when implementing the integration to ensure proper and safe use of the devices.

Finally, you will need to restart your device for the change in the operating mode to take effect.

If you need to use the device in non-integrated mode, you should configure the operating_mode field with the value STANDALONE.

If you have already activated the point-of-sale mode on a device via API and, for some reason, need to reconfigure it, you can do it directly from the device, and there will be no need to resort to the API again.

Prerequisites

Know what are the necessary requirements to integrate Mercado Pago Point via API.

Payment processing

Create a payment intent and assign it to a Point device.