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:
- Access Your integrations.
- Within the Your applications section, click on the "+" symbol to create your first application, or select "Create new application" if you already have others.
- Give your applications a name in order to easily find it later.
- Select "Mercado Pago Point" as the product you are going to integrate.
- Accept our Terms and Conditions.
¡And you’re done!
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.
- On the Devsite, navigate to Your integrations and click on the card corresponding to your application.
- On the application page, go to the Test accounts section and click the + Create test account button.
- In the "Create new account" screen, enter a description for the account identification. Example: "Seller - Store 1".
- 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.
- 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.
- 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.
- Click on Create test account.
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.
In addition, you can also create test users using the following command:
curl
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"}'
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:
bash
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:
json
{
"operating_mode": "PDV"
}
operating_mode
field with the value STANDALONE
.