Start testing

With this tutorial guide you on how to create a global and marketplace test user, buy, sell between test users and simulate the same actions allowed for a real user among test users without paying for any charges or getting penalties, without jeopardizing a real user’s reputation.

Important:
All test operations must be maked out with test users. Remember that personal accounts should not be used for testing.

Contents

→Create a global test user
→Create a marketplace test user
→Considerations
→Buy and sell between users test


Create a global test user

You need to have a token to create a test user. If you haven’t got your access_token yet, you may read the Authentication & Authorization guide, or you can simple come back here when you are ready to test. You only need to send on the on the JSON the country where you want to operate.

Consult our SITES resource of our API to know the site_id of each country. We recommend the creation of at least one seller user and one buyer user, to make transactions between them.

Example:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X POST -H "Content-Type: application/json" -d
'{
    "site_id":"CBT"
}'
https://api.mercadolibre.com/users/global_selling_test_user

Response:

{
  "id":120506781,
    "nickname":"TEST0548",
    "password":"qatest328",
    "site_status":"active"
}

Great! On the response you get the User_id, Nickname, Password and current status of your new test user.

By default, the country of origin for CBT users is US, in the case of wanting to use China as origin, the following request must be sent:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X POST -H "Content-Type: application/json" -d
'{
   "site_id": "CBT",
   "country_id": "CN"   
}'
https://api.mercadolibre.com/users/global_selling_test_user

Response:

{
    "id":120506782,
    "nickname":"TEST0549",
    "password":"qatest876",
    "site_status":"active"
}

Create a marketplace test user

In addition, you can create marketplace test users, in order to be able to do end to end tests, buying and selling between these.

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-type: application/json" -d
'{
  	"site_id":"MLM"
}'
https://api.mercadolibre.com/users/test_user

Response:

{
   "id": 720984821,
   "nickname": "TETE4387547",
   "password": "qatest5129",
   "site_status": "active",
   "email": "test_user_24321325@testuser.com"
}

Considerations

When working with test users, you need to take into account the following considerations:

  • Once you have created the test user for a global seller, you have to access global-selling to configure the marketplace account’s.
  • You can create up to 10 test users with your mercadolibre account.
  • Test users won’t be active for too long, but once they expire, you can create new ones.
  • List under the “Others” category as much as possible.
  • Test users can simulate operations only with listings from other test users: they can only buy, sell, ask questions, etc., in test list, created by test accounts.
  • Test users showing no activity (buy, ask, publish, etc.) during 60 days are immediately removed.
  • Test items are removed regularly.
  • The email´s validation code for test users will be equal to the last digits of the user id and can have 4 or 6 digits. For example, for user id 653764425, the code could be 764425.

Great! you just finished our Getting Started section. To continue learning, we recommend you to visit our API docs.

 

Buy and sell between users test

Remember that tests on the platform and all transactions must be done with test users. In addition, personal accounts should not contain ads. If you want to simulate purchases between test users, you could use our test cards. Remember that testing on the platform and all transactions must be done between test users. In addition, personal accounts must not contain listings for this purpose.

Note:
Bear in mind that you should upload fictitious data and that for security, when running tests, we don't add bank names to cards available for testing.

Next: Manage users.