Prerequisites

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

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.

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 and click on Create application.
2. Name the application so you can identify it later.
3. Select the option In-person Payments and then QRCode
4. Optionally, you can select the integration mode, either attended or dynamic.
5. Accept our Terms and Conditions, and then click on Create application again. Done!

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.

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.

Once the test users are created, you can begin with your integration by creating a store and POS (Point of Sale).

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. You can learn more information about it reading our documentation.

When a Mercado Pago account is created, it is assigned wiyh a User ID, if they are users, or a Cust ID, if they are a seller. Both are unique IDs that are automatically generated, and will allow the integrations to be associated with each account by including them in the API requests.

When you make integrations for third parties, the sponsor_id parameter will allow you to identify the orders that are placed by your point of sale. You will have to send the Sponsor ID in the in-store orders API requests. Follow the instructions below to learn how to collect and send this information.

1. If you haven't done so yet, create an account on the Mercado Pago portal.
2. Obtain the user identification (Cust ID or User ID) of your account by accessing the details of the application that you have created earlier.
3. Include the User ID of your integrator account in the seller's Sponsor ID.
4. Submit the Sponsor ID on all QR transactions, as shown in our API Reference.