Suggest edit
Help us improve the documentation
Did you see wrong information and would you like us to explain something else or improve our manuals? Please leave your suggestions on GitHub.

Previous requirements to integrate

Glossary

We know some concepts may be new for you. Before starting, here's a cheatsheet.

Term Description
Credentials Your credentials are the keys we give you so you can set up your integrations. To find them, go to your credentials and select the productive ones.
ACCESS_TOKEN The private app key to generate payments. You'll find it on credentials section. You must use it to identify yourself in your integrations. Always use the Production Mode credentials.
USER_ID Buyer's user ID in Mercado Pago, consist on the last digits on the access_token, after the last dash. Also known as the COLLECTOR_ID.
SPONSOR_ID Supplier's ID on the integrated system with Mercado Pago. Consist on the last digits of the access_token, after the last dash mark. sponsor_ID must be different than USER_ID.
Store A physical shop in which your clients can get products and services. You can have multiple stores on one account.
Point of sale (POS) A place to perform a transaction on a store or physical shop. Each POS will be linked with a unique QR code.
Order A purchase made by your client. Contains a list of product with an associated cost.

Do you have any questions? Check our FAQs.

Previous requirements

To continue, you must:

1. Access to Mercado Pago or Mercado Libre account

To start the integration, you must have a Mercado Pago or Mercado Libre account. If you don't have an account yet, you can create one here.

Note

If you were to operate in behalf of others, you can work with their credentials safer and easier through Marketplace.

2. Generate test users

To make tests 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" \
"https://api.mercadopago.com/users/test_user?access_token=PROD_ACCESS_TOKEN
-d '{"site_id":"MLC"}'
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 to save 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 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.


Next steps

Your search returns no results.

Verifique a ortografia de termos de pesquisa ou teste com outras palavras-chave.