Integra Checkout Pro
Integrar el Checkout Pro de Mercado Pago te permite cobrar a través de nuestro formulario web desde cualquier dispositivo de manera simple, rápida y segura.
Usa los ejemplos descargables para conocer la integración completa o para adaptarlos según lo que necesites.
¿Cómo me integro?
Genera tu preferencia
1.1 Suma la SDK descargada de Mercado Pago en tu proyecto.
1.2 Agrega las credenciales para habilitar el uso de la SDK de Mercado Pago.
1.3 Configura la preferencia según tu producto o servicio.
Suma el checkout a tu sitio
Pasos para integrarte
Instalar el Checkout Pro consta de dos pasos:
1. Genera tu preferencia
Escribe el siguiente código que consta de tres partes:
1.1 Suma la SDK de Mercado Pago en tu proyecto:
<?php
// SDK de Mercado Pago
require __DIR__ . '/vendor/autoload.php';
?>
// SDK de Mercado Pago
const mercadopago = require ('mercadopago');
// SDK de Mercado Pago
import com.mercadopago.MercadoPago;
# SDK de Mercado Pago
require 'mercadopago.rb'
// SDK de Mercado Pago
using MercadoPago;
1.2 Agrega las credenciales para habilitar el uso de la SDK de Mercado Pago:
<?php
// SDK de Mercado Pago
require __DIR__ . '/vendor/autoload.php';
// Agrega credenciales
MercadoPago\SDK::setAccessToken('PROD_ACCESS_TOKEN');
?>
// SDK de Mercado Pago
const mercadopago = require ('mercadopago');
// Agrega credenciales
mercadopago.configure({
access_token: 'PROD_ACCESS_TOKEN'
});
// SDK de Mercado Pago
import com.mercadopago.MercadoPago;
// Agrega credenciales
MercadoPago.SDK.setAccessToken("PROD_ACCESS_TOKEN");
# SDK de Mercado Pago
require 'mercadopago.rb'
# Agrega credenciales
$mp = MercadoPago.new('PROD_ACCESS_TOKEN')
// SDK de Mercado Pago
using MercadoPago;
// Agrega credenciales
MercadoPago.SDK.AccessToken = "PROD_ACCESS_TOKEN";
1.3 Configura la preferencia según tu producto o servicio:
<?php
// SDK de Mercado Pago
require __DIR__ . '/vendor/autoload.php';
// Agrega credenciales
MercadoPago\SDK::setAccessToken('PROD_ACCESS_TOKEN');
// Crea un objeto de preferencia
$preference = new MercadoPago\Preference();
// Crea un ítem en la preferencia
$item = new MercadoPago\Item();
$item->title = 'Mi producto';
$item->quantity = 1;
$item->unit_price = 75;
$preference->items = array($item);
$preference->save();
?>
// SDK de Mercado Pago
const mercadopago = require ('mercadopago');
// Agrega credenciales
mercadopago.configure({
access_token: 'PROD_ACCESS_TOKEN'
});
// Crea un objeto de preferencia
let preference = {
items: [
{
title: 'Mi producto',
unit_price: 100,
quantity: 1,
}
]
};
mercadopago.preferences.create(preference)
.then(function(response){
// Este valor reemplazará el string "<%= global.id %>" en tu HTML
global.id = response.body.id;
}).catch(function(error){
console.log(error);
});
// SDK de Mercado Pago
import com.mercadopago.MercadoPago;
// Agrega credenciales
MercadoPago.SDK.setAccessToken("PROD_ACCESS_TOKEN");
// Crea un objeto de preferencia
Preference preference = new Preference();
// Crea un ítem en la preferencia
Item item = new Item();
item.setTitle("Mi producto")
.setQuantity(1)
.setUnitPrice((float) 75);
preference.appendItem(item);
preference.save();
# SDK de Mercado Pago
require 'mercadopago.rb'
# Agrega credenciales
$mp = MercadoPago.new('PROD_ACCESS_TOKEN')
# Crea un objeto de preferencia
preference_data = {
"items": [
{
"title": "Mi producto",
"unit_price": 100,
"quantity": 1
}
]
}
preference = $mp.create_preference(preference_data)
# Este valor reemplazará el string "<%= @preference_id %>" en tu HTML
@preference_id = preference["response"]["id"]
// SDK de Mercado Pago
using MercadoPago;
// Agrega credenciales
MercadoPago.SDK.AccessToken = "PROD_ACCESS_TOKEN";
// Crea un objeto de preferencia
Preference preference = new Preference();
// Crea un ítem en la preferencia
preference.Items.Add(
new Item()
{
Title = "Mi producto",
Quantity = 1,
CurrencyId = CurrencyId.CLP,
UnitPrice = (decimal)75
}
);
preference.Save();
curl -X POST \
'https://api.mercadopago.com/checkout/preferences' \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cache' \
-H 'Authorization: Bearer **PROD_ACCESS_TOKEN**' \
-d '{
"items": [
{
"title": "Mi producto",
"quantity": 1,
"unit_price": 75
}
]
}'
Importante
El valor de
unit_price debe ser entero.Acepta pagos solo de usuarios registrados
Si quieres aceptar pagos únicamente de usuarios registrados, con tarjetas y dinero en cuenta de Mercado Pago, ingresa en esta sección para más información.
2. Suma el checkout a tu sitio
Por último, suma el siguiente código para mostrar el botón de pago de tu Checkout Pro en el lugar que quieras que aparezca.
<script
src="https://www.mercadopago.cl/integrations/v1/web-payment-checkout.js"
data-preference-id="<?php echo $preference->id; ?>">
</script>
<script
src="https://www.mercadopago.cl/integrations/v1/web-payment-checkout.js"
data-preference-id='<%= global.id %>'>
</script>
<script
src="https://www.mercadopago.cl/integrations/v1/web-payment-checkout.js"
data-preference-id="${preference.id}">
</script>
<script
src="https://www.mercadopago.cl/integrations/v1/web-payment-checkout.js"
data-preference-id="<%= @preference_id %>">
</script>
<script
src="https://www.mercadopago.cl/integrations/v1/web-payment-checkout.js"
data-preference-id="@Html.DisplayFor(model => model.id)">
</script>
Importante
No te olvides de acceder desde otro navegador o cerrar la sesión de tu cuenta de Mercado Pago antes de probarlo. No puedes pagar con la misma cuenta que creaste el formulario de pago.
¡Excelente! Terminaste tu integración.
Haz clic en el link dentro de tu sitio y prueba la integración de tu Checkout Pro.
Ejemplos descargables
Checkout Pro
Te dejamos ejemplos completos de integración en GitHub para PHP o NodeJS para que puedas descargar al instante.