Prerequisites - QR Code - Mercado Pago Developers
Which documentation are you looking for?

Do not know how to start integrating? 

Check the first steps


Keep these aspects in mind before you start:

  • Access to an account
  • Create an application
  • Generate test users
  • Obtain your Access token
  • Identify your integration

1. Access to an account

To start integrating, you must have a Mercado Pago or Mercado Libre account.

You can sign in with an existing account or Create a new account.

2. Create an application

Creating a credential is necessary to make transactions using the Mercado Pago integration. This credential contains an ID and an Access Token required to make transactions using a Mercado Pago account.

You must create an application to obtain credentials and set up webhook notifications.

It's quite easy to do:

  1. Enter Your integrations.
  2. Select the + symbol in Your applications section to create a new application.
  3. Name the application to identify it later.
  4. Accept our Terms and Conditions. Done!
If your POS integrator has several tenants, see topic 4 and 5. Check your integration security and implement OAuth.

3. 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.

4. Obtain your Access Token (OAuth)

If you are an integrator that works with several retailers enabling them to operate with Mercado Pago, we recommend to perform the OAuth - authentication between accounts process. The process enables customers securely share personal data with a third-party system.

The Access Token is not shareable in any way other than through OAuth.

5. Identify your integration (Sponsor ID)

To identify the orders placed by your POS (Point Of Sale), include the Sponsor ID, and check the in-store orders APIs on how to send this information.

Step by step:

  • Create an account on the Mercado Pago portal (Integrator ID).
  • Obtain the user identification (Cust ID or User ID) of your account.
  • Include the User ID of your integrator account in the seller's Sponsor ID.
  • Submit the Sponsor ID on all QR transactions. See API .