Integrate the API to your Points of Sale

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

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.

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!

Once you have created an application, you will be able to access your credentials. With them you can connect an integration to your account and configure it your way.

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. In Devsite, access the menu Your Integrations > Test Accounts and click on the Create Test Account button.
2. On the "Create New Account" screen, enter a description for the account identification. Example: "Salesperson - store 1".
3. Next, select the country of operation for the account. This information cannot be edited later and, in addition, Buyer and Seller users must be from the same country.
4. Fill in a fictitious amount of money that will serve as a reference for you to test your applications. This amount will appear as a balance in the test user's Mercado Pago account and can be used to simulate payments, as well as with a test card.
5. Click Create Test Account.

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

• Country location of origin of the account selected in your registration.
• Account ID: description for test account identification.
• User: auto-generated test account username. This username is used to log in with the test user.
• Password: automatically generated test user account access password. To generate a new password, click on the 3 vertical dots at the end of the table row and select the option Generate new password.
• Creation Date: date the test account was created.

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}' \
"https://api.mercadopago.com/users/test" \
-d '{"site_id":"MLA","description" : "a description"}'

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.

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.

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.

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 'https://api.mercadopago.com/point/integration-api/devices/:deviceId' \
--header 'Authorization: Bearer ${ACCESS_TOKEN}' \
--header 'Content-Type: application/json' \
--data-raw '{
   "operating_mode": "PDV"
}'

You will receive a response like this:

{
"operating_mode": "PDV"
}