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.

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.

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.

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.

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"
}

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.