Integrate API - Integrate with POS - Mercado Pago Developers
Which documentation are you looking for?

Do not know how to start integrating? 

Check the first steps

Integrate the API to your Points of Sale

Follow these steps to start integrating the Integrations API to your Points of Sale.

1. Get identification credentials

Access a Mercado Pago account

In order to start the integration, it is necessary to have a Mercado Pago or Mercado Libre account. You can access an existing account or create a new one.

Create an application

Next, you will need to create an application to obtain the credentials. It's easy, we’ll tell you how to do it:

  1. Access Your integrations.
  2. Within the Your applications section, click on the "+" symbol to create your first application, or select "Create new application" if you already have others.
  3. Give your applications a name in order to easily find it later.
  4. Select "Mercado Pago Point" as the product you are going to integrate.
  5. Accept our Terms and Conditions.

¡And you’re done!

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

Access your application credentials

Once you have created an application, you will be able to access your credentials. You can find them in the Application details > Credentials within the Developer dashboard. With them you can connect an integration to your account and configure it your way.

Generate test users

Use test accounts to ensure that your integration supports all possible flows and scenarios. They have the same features as a real Mercado Pago account, which allows you to test the functioning of the integrations you are developing.

To perform the test, you must have at least two accounts:

  • Seller: account required to configure application and credentials. This is your user account.
  • Buyer: account required to test the purchase process.

In addition to these accounts, it is also important to use test cards to test payment integration and simulate the purchase process, as well as balance in the test user's Mercado Pago account. See more details below.

To create accounts and test how the integrations work, follow the steps below.

  1. On the Devsite, navigate to Your integrations and click on the card corresponding to your application.
  2. On the application page, go to the Test accounts section and click the + Create test account button.
  3. In the "Create new account" screen, enter a description for the account identification. Example: "Seller - Store 1".
  4. Next, select the operating country for the account. This information cannot be edited later, and furthermore, the Buyer and Seller users need to be from the same country.
  5. Fill in with a fictional money value that will serve as a reference for testing your applications. This value will appear as the balance in the Mercado Pago account of the test user and can be used for payment simulation, just like with the test cards.
  6. Authorize the use of your personal data in accordance with the Privacy Statement and ensure that your account uses Mercado Pago's tools in accordance with the Terms and Conditions by checking the checkbox.
  7. Click on Create test account.
Use of credentials
Always use the production credentials when working with a test user.
You can generate up to 15 test user accounts simultaneously, and for now, it is not possible to delete them.

Done! The test account has been created and will be displayed in the table with the following information:

  • Country: Origin location of the account selected in your registration.
  • Account identification: Description for the test account identification.
  • User: Automatically generated username of the test account. This is the username used to log in with the test user.
  • Password: Automatically generated password to access the test user account. To generate a new password, click on the vertical ellipsis (three dots) at the end of the table row and select the Generate new password option.
  • Created on: Date when the test account was created.
To edit the account identification or add more fictional money to test your applications, click on the vertical ellipsis (three dots) at the end of the table row and select the Edit data option.

You can generate up to 15 test user accounts simultaneously, and for now, it is not possible to delete them.

In addition, you can also create test users using the following command:


curl -X POST \
-H "Content-Type: application/json" \
-H 'Authorization: Bearer ${TEST_ACCESS_TOKEN}' \
"" \
-d '{"site_id":"MLA","description" : "a description"}'

2. Associate your Point device with your Mercado Pago account

Now you need to link your Point device to your Mercado Pago account. In order to do that, you need to have our application on your cell phone. You can get it for the operating systems iOS and Android. You must also have a Point device.

Scan the QR code of your Point device

First, log into the Mercado Pago application. Then, click on the QR icon and scan the code that displays when you turn on your Point device. And that’s it, your Point device will be linked to your account.

Configure your store and your point of sale

Once you have linked your Point device to your Mercado Pago account, you must complete your store data and configure your point of sale on the Mercado Pago site. To do this, you must access Your business> Stores and points of sale.

Activate the integrated mode on your Point device

To integrate your Point device with our API it is necessary to activate the point of sale (POS) operating mode. To achieve this, consult the devices through our Get devices API and run the following command:


 curl --location --request PATCH '' \
--header 'Authorization: Bearer ${ACCESS_TOKEN}' \
--header 'Content-Type: application/json' \
--data-raw '{
   "operating_mode": "PDV"
The POS API integrated mode is only available to be operated by a store operator. If it is implemented in self-service mode, it will be the full responsibility of the business since the devices are not enabled to be used in this type of business model.

You will receive a response like this:


"operating_mode": "PDV"
In case you need to use the device in non-integrated mode, you must configure the operating_mode field with the value STANDALONE.
It is necessary to restart the device for the change to take effect.