Prerequisites to get started

Find out what you need to know to integrate our Checkout API.

Have your credentials handy

Your credentials are the keys we provide you to configure your integrations. In this case, you will use a public and a private key.

The Public Key grants access to the resources that your frontend needs. It allows you to collect credit card data and turn it into a representative token that you can send to your servers securely to create a payment.
The Private Key, or Access Token, will allow you to call the rest of the APIs from your servers. For example, to process a payment, make a refund, or save cards.

Check the Credentials section to learn how to obtain these informations.

Do you have any questions about credentials? Read Credentials for more information.

Always use our libraries

We recommend that you use our official libraries for your integration. This helps protect your customer's sensitive data, meet the required security standards, and keep yourself up to date.

Include MercadoPago.js

Client-Side

MercadoPago.js allows you to manage the card data to comply with the necessary security requirements and avoid sending sensitive data to your servers. For this, our library generates a payment token that represents this information and allows you to operate safely. You can use it by adding the following code to your website:

<script src="https://sdk.mercadopago.com/js/v2"></script>

This documentation uses the new MercadoPago.js V2 version. To see the previous version, go to the old Checkout API section.

Install Mercado Pago SDK

Server-Side

Install an official SDK to simplify your interaction with our APIs.

Install Composer to use the SDK. Then run the following code on the command line:

          
php composer.phar require "mercadopago/dx-php:dev-master"

To install the SDK you must execute the following code on the command line of your terminal using npm:

          
npm install mercadopago

To install the SDK in your Maven project, add the following dependency in your pom.xml file and then run ´maven install´.

          
<dependency>
            <groupId> com.mercadopago </groupId>
            <artifactId> sdk-java </artifactId>
            <version> 1.9.0 </version>
</dependency>

The Mercado Pago SDK is available as a gem, to install it you must execute the following code on the command line:

          
gem install mercadopago-sdk

Use NuGet to install the Mercado Pago SDK .NET. To do this, run the following command on your terminal:

          
nuget install mercadopago-sdk

The Mercado Pago SDK is available as a pip, to install it you must execute the following code on the command line:

          
pip3 install mercadopago

Learn our API References

If you can't use our official SDKs, you will have all the information about data queries and responses available to interact directly with our APIs in API References.

Meet the requirements for the production environment

When you develop your integration, consider all the requirements for the production environment. This process can ensure your customer's data security, compliance with legal standards or provisions in each country, and the best shopping experience for your customers.

Once your integration is ready, you just need to fill out the form for to go to production in the Credentials section to start receiving payments.

Next steps

REQUIRED

Integrate Checkout API for cards

Create and configure your own payment experience.

RECOMMENDED

API References

Find all the information required to interact with our APIs.