Home
Documentation
Resources
Partners
Community

Partners

Discover our program for agencies or developers that offer integration services and sellers who want to hire them.

Community

Get the latest news, ask others for help and share your knowledge.

Credentials - Your integrations - Mercado Pago Developers
Which documentation are you looking for?

Do not know how to start integrating? 

Check the first steps

Credentials

Credentials are exclusive access keys used to identify an integration in your account. They are necessary to securely capture payments on online stores and other platforms.

Each application will have two pairs of production credentials and, when applicable to the product, a pair of test credentials.

Obtaining credentials

To obtain the credentials, whether for production or testing, you must first create an application within Mercado Pago. If you have not created any yet, access the Developer panel documentation for more information.

Next, learn how to obtain your credentials and in which situations they should be used.

Production credentials

Production credentials are a set of keys that allow you to receive real payments on stores and other applications.

You can obtain your production credentials in two ways:

  1. By accessing Your integrations > "Your application" > Production > Production credentials.

Como acessar as credenciais através das Suas Integrações

  1. Through your Mercado Pago account, by accessing Your business > Settings > Management and administration > Credentials through the Developer dashboard.

Como acessar as credenciais através do Mercado Pago

When accessing your production credentials, the following credential pairs will be displayed: Public Key and Access Token, along with Client ID and Client Secret.

Public Key and Access Token

The Public Key and the Access Token are credentials that will be used, not necessarily together, in integrations made with Mercado Pago's payment solutions, including:

These credentials are also used in Mercado Pago plugin integrations with e-commerce platforms.

Important
In some payment solutions, the Public Key and Access Token will also be used to test the integration. However, in these situations, the credentials of a test account previously created.
TypeDescription
Public keyThe application's public key is usually used on the frontend. It allows, for example, accessing information about payment methods and encrypting card data.
Access tokenThe application's private key that should always be used on the backend to generate payments. It is essential to keep this information secure on your servers.

For more information on which credentials will be needed for your integration, consult the specific documentation of the solution being integrated.

Client ID and Client Secret

The Client ID and Client Secret are credentials used in some older integrations with e-commerce platforms and primarily in integrations that use OAuth as a protocol for obtaining private information from Mercado Pago accounts. Specifically, they are used during the Client Credentials flow (grant type), which allows access to a resource on one's own behalf and obtaining an Access Token without user interaction.

TypeDescription
Client IDUnique identifier that represents your integration.
Client secretA private key used in some plugins to generate payments. It is extremely important to keep this information secure on your servers and not allow access to any system user or intruder.

Test credentials

Test credentials are a set of keys used to test the integration. They can be combined with test credit cards to simulate transactions and verify the correct operation of the integrations.

You can obtain your test credentials, as long as they are available for your integration, by accessing Your integrations > "Your application" > Test credentials.

Important
These credentials are not available for all Mercado Pago products, so they will only be active in applications where you have selected a product that requires them.

Como acessar as credenciais através das Suas Integrações

When creating an application, if you selected a Mercado Pago product that does not require test credentials, you will see the following screen:

Blocked test account screen

If you are integrating a product that does not use test credentials, you will not be able to use them. Instead, you should use test accounts to test your integration properly.

Test accounts do not have test credentials enabled. If you are using a test account, you will need to use its production credentials.

Share credentials

When you receive assistance in integrating or setting up your payment channels, you can safely share your credentials with another Mercado Pago account. To do so, you can do it in two ways:

Through Your integrations on Mercado Pago Developers:

  1. Go to Your integrations and access an application.
  2. Go to the Test or Production section, depending on the type of credential you want to share.
  3. Once you select the credentials, go to the Share credentials with a developer section and click on the Share credentials button.
  4. Enter the email of the person you want to grant access to. Remember that the email must be associated with a Mercado Pago account.

Share credentials in Your Integrations

Through Mercado Pago:

  1. Access your Mercado Pago account.
  2. Go to Your business > Settings > Management and Administration > Credentials.
  3. On that page, select the production credentials or test credentials, depending on what you want to share.
  4. Once you select the credentials, go to the Share credentials with a developer section and click on the Share credentials button.
  5. Select the application from which you want to share your credentials and enter the email of the person you want to grant access to. Remember that the email must be associated with a Mercado Pago account.

Share credentials in Mercado Pago

Important
You can share the credentials up to a maximum of 10 times with other Mercado Pago accounts. If you reach this limit, you will need to delete old permissions, which will not impact integrations already configured.

Also, if for security reasons you do not wish to continue sharing your credentials, you can cancel access.

Renew credentials

If for security reasons or any other relevant reason you need to renew your credentials, click on More options (three dots at the end of the card) > Renew.

Attention
Note that if the credentials you renew are being used in any of your integrations, they will be affected, and you will need to replace them with the new credentials you obtain after the renewal.

Como renovar suas credenciais