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. With them you can connect an integration to your account and configure it your way.
Generate test users
You can test your integrations in a controlled environment with test users. You can create them 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":"MLB","description" : "a description"}'
You can generate up to 10 test user accounts simultaneously. Keep in mind that test users expire after 60 days without activity in Mercado Pago.
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, run the following command:
bash
curl --location --request PATCH 'https://api.mercadopago.com/point/integration-api/devices/{{device.id}}' \
--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
.