Prerequisites - QR Code - Mercado Pago Developers

Previous requirements to integrate

Keep these aspects in mind before you start:

1. Access to an account

To start the integration, 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

To transact via Mercado Pago integration, a credential must be created. This credential will have an identification and the Access Token, only with this token will it be possible to transact using a Mercado Pago account. Create an application to get credentials and set up webhook notifications.

It's easy and we explain how to do it:

  1. Enter Your integrations.
  2. Select “New application” or “Create your first application”.
  3. Give it a name so you can identify it later on.
  4. Accept our Terms and Conditions. Done!
Note
In case of POS integrated with several tenants, see topic 4 and 5. Pay attention to the security of your integration and implement OAuth.

3. Generate test users

To make tests it is necessary to have at least two users: a buyer and a seller.

Execute the following command to generate a test user:

curl

curl -X POST \
-H "Content-Type: application/json" \
-H 'Authorization: Bearer ACCESS_TOKEN' \
"https://api.mercadopago.com/users/test_user"
-d '{"site_id":"MLA"}'
Note
Productive credentials should be used for the account you'll be operating with.

Response:

json

{
"id": 123456,
"nickname": "TT123456",
"password": "qatest123456",
"site_status": "active",
"email": "test_user_123456@testuser.com"
}
IMPORTANT
  • You can generate up to 10 test accounts at the same time. Because of that, we recommend saving email and password for each one.
  • Test users expire after 60 days of no activity on Mercado Pago.
  • To make test payments we recommend to use low amounts.
  • Both buyer and seller should test users.
  • Use test cards, because it is not possible to withdraw money.
  • Once the test users are created, you can start with the integration and create the Stores and Point of Sale.

    4. How to collect Access Token (OAuth)

    For you integrator, who will work with several stores that use Mercado Pago digital wallet, we advise you to do the OAuth process - authentication between accounts, this process consists of the customer allowing their data to be shared with a third party system in a secure way.

    The access token cannot be shared in any way other than OAuth. More information

    5. Cómo identificar tu integración

    To identify the orders that are transacted by your management system, include the sponsor ID, see in the instore orders APIs how you will send this information.

    Step by step:

  • Create an account on the Mercado Pago portal (Integrator identification).
  • Collect Collector ID (Cust ID or User ID) of your account.
  • Include the Collector ID of your Integrator account inside the Sponsor ID of the seller.
  • Submit Sponsor ID on all QR transactions. See api.