Integrar Checkout Pro
La integraciĆ³n con Checkout Pro te permite cobrar a travĆ©s de nuestro formulario web desde cualquier dispositivo de forma sencilla, rĆ”pida y segura.
En esta documentaciĆ³n encontrarĆ”s todos los pasos necesarios para integrar Checkout Pro a travĆ©s de nuestras SDKs. Para hacer esto, sigue los pasos que se describen a continuaciĆ³n.
Prueba nuestro Checkout Pro
Construye la experiencia visual de Checkout Pro en tiempo real. Cuando estĆ© todo listo, descarga o copia el cĆ³digo generado para agregarlo a tu sitio o compartirlo con un desarrollador.

Instalar SDK de Mercado Pago
Server-Side
El primer paso para integrar Checkout Pro es instalar el SDK de Mercado Pago en tu proyecto. Para hacer esto, usa uno de los cĆ³digos disponibles a continuaciĆ³n.
php composer.phar require "mercadopago/dx-php"
Para instalar el SDK debes ejecutar el siguiente cĆ³digo en la lĆnea de comandos de tu terminal usando npm:
npm install mercadopago
Para instalar el SDK en tu proyecto Maven, debes agregar la siguiente dependencia en tu archivo pom.xml
y ejecutar maven install
en la lĆnea de comandos de tu terminal:
<dependency>
<groupId>com.mercadopago</groupId>
<artifactId>sdk-java</artifactId>
<version>2.1.7</version>
</dependency>
Para instalar la SDK, debes ejecutar el siguiente cĆ³digo en la lĆnea de comandos de tu terminal usando Gem:
gem install mercadopago-sdk
Para instalar la SDK debes ejecutar el siguiente cĆ³digo en la lĆnea de comandos de tu terminal usando NuGet:
nuget install mercadopago-sdk
Para instalar el SDK debes ejecutar el siguiente cĆ³digo en la lĆnea de comandos de tu terminal usando Pip:
pip3 install mercadopago
go get -u github.com/mercadopago/sdk-go
Crear preferencia
Server-Side
Las preferencias son conjuntos de informaciĆ³n que te permiten configurar un producto o servicio que deseas cobrar, como el precio y la cantidad, asĆ como otras configuraciones relacionadas con el flujo de pago definido.
Para crear una preferencia, utiliza uno de los SDK disponibles a continuaciĆ³n, completando los atributos con la informaciĆ³n respectiva.
<?php
// SDK de Mercado Pago
use MercadoPago\MercadoPagoConfig;
// Agrega credenciales
MercadoPagoConfig::setAccessToken("PROD_ACCESS_TOKEN");
?>
// SDK de Mercado Pago
import { MercadoPagoConfig } from 'mercadopago';
// Agrega credenciales
const client = new MercadoPagoConfig({ accessToken: 'YOUR_ACCESS_TOKEN' });
// SDK de Mercado Pago
import com.mercadopago.MercadoPagoConfig;
// Agrega credenciales
MercadoPagoConfig.setAccessToken("PROD_ACCESS_TOKEN");
# SDK de Mercado Pago
require 'mercadopago'
# Agrega credenciales
sdk = Mercadopago::SDK.new('PROD_ACCESS_TOKEN')
// SDK de Mercado Pago
using MercadoPago.Config;
// Agrega credenciales
MercadoPagoConfig.AccessToken = "PROD_ACCESS_TOKEN";
# SDK de Mercado Pago
import mercadopago
# Agrega credenciales
sdk = mercadopago.SDK("PROD_ACCESS_TOKEN")
import (
"github.com/mercadopago/sdk-go/pkg/config"
)
cfg, err := config.New("{{ACCESS_TOKEN}}")
if err != nil {
fmt.Println(err)
}
Cuando termines de crear la preferencia, debes configurarla de acuerdo con tu producto o servicio. Para ello, utiliza uno de los cĆ³digos disponibles a continuaciĆ³n, completando los atributos con la informaciĆ³n que corresponda.
<?php
$client = new PreferenceClient();
$preference = $client->create([
"items"=> array(
array(
"title" => "Mi producto",
"quantity" => 1,
"unit_price" => 85
)
)
]);
?>
const preference = new Preference(client);
preference.create({
body: {
items: [
{
title: 'Mi producto',
quantity: 1,
unit_price: 85
}
],
}
})
.then(console.log)
.catch(console.log);
PreferenceItemRequest itemRequest =
PreferenceItemRequest.builder()
.id("1234")
.title("Games")
.description("PS5")
.pictureUrl("http://picture.com/PS5")
.categoryId("games")
.quantity(2)
.currencyId("BRL")
.unitPrice(new BigDecimal("4000"))
.build();
List<PreferenceItemRequest> items = new ArrayList<>();
items.add(itemRequest);
PreferenceRequest preferenceRequest = PreferenceRequest.builder()
.items(items).build();
PreferenceClient client = new PreferenceClient();
Preference preference = client.create(request);
# Crea un objeto de preferencia
preference_data = {
items: [
{
title: 'Mi producto',
unit_price: 75.56,
quantity: 1
}
]
}
preference_response = sdk.preference.create(preference_data)
preference = preference_response[:response]
# Este valor reemplazarĆ” el string "<%= @preference_id %>" en tu HTML
@preference_id = preference['id']
// Crea el objeto de request de la preference
var request = new PreferenceRequest
{
Items = new List<PreferenceItemRequest>
{
new PreferenceItemRequest
{
Title = "Mi producto",
Quantity = 1,
CurrencyId = "MXN",
UnitPrice = 75.56m,
},
},
};
// Crea la preferencia usando el client
var client = new PreferenceClient();
Preference preference = await client.CreateAsync(request);
# Crea un Ćtem en la preferencia
preference_data = {
"items": [
{
"title": "Mi producto",
"quantity": 1,
"unit_price": 75.76,
}
]
}
preference_response = sdk.preference().create(preference_data)
preference = preference_response["response"]
client := preference.NewClient(cfg)
request := preference.Request{
Items: []preference.ItemRequest{
{
Title: "My product",
Quantity: 1,
UnitPrice: 75.76,
},
},
}
resource, err := client.Create(context.Background(), request)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(resource)
Eligir el tipo de integraciĆ³n
Client-Side
Con la SDK instalada y configurada correctamente en tu proyecto, ya estĆ”s listo para continuar con la integraciĆ³n. Para ello, elige el tipo de integraciĆ³n que mejor se adapte a tus necesidades, ya sea Web o Mobile, y sigue los pasos detallados en el apartado correspondiente al tipo de soluciĆ³n elegida.
Para instalar el SDK debes ejecutar el siguiente cĆ³digo en la lĆnea de comandos de tu terminal usando Composer: