Integre o Checkout Pro
Integrar Checkout Pro do Mercado Pago te permite cobrar através do nosso formulário web de qualquer dispositivo de forma simples, rápida e segura.
Use os exemplos para download para conhecer a integração completa ou para adaptá-los de acordo com o que precisa.
Como me integro?
Gere sua preferência
1.1 Adicione o SDK baixado do Mercado Pago no seu projeto.
1.2 Adicione as credenciais para habilitar o uso do SDK do Mercado Pago.
1.3 Configure a preferência conforme seu produto ou serviço.
Adicione o checkout ao seu site
Etapas para se integrar
Instalar o Checkout Pro requer duas etapas:
1. Gere sua preferência
Insira o seguinte código que consta de três partes:
1.1 Adicione o SDK do Mercado Pago no seu projeto:
<?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 Adicione as credenciais para habilitar o uso do SDK do Mercado Pago:
<?php
// SDK de Mercado Pago
require __DIR__ . '/vendor/autoload.php';
// Configura credenciais
MercadoPago\SDK::setAccessToken('PROD_ACCESS_TOKEN');
?>
// SDK de Mercado Pago
const mercadopago = require ('mercadopago');
// Configura credenciais
mercadopago.configure({
access_token: 'PROD_ACCESS_TOKEN'
});
// SDK de Mercado Pago
import com.mercadopago.MercadoPago;
// Configura credenciais
MercadoPago.SDK.setAccessToken("PROD_ACCESS_TOKEN");
# SDK de Mercado Pago
require 'mercadopago.rb'
# Configura credenciais
$mp = MercadoPago.new('PROD_ACCESS_TOKEN')
// SDK de Mercado Pago
using MercadoPago;
// Configura credenciais
MercadoPago.SDK.AccessToken = "PROD_ACCESS_TOKEN";
1.3 Configure a preferência conforme seu produto ou serviço:
back_urls
se você quiser retornar ao seu site ao final do pagamento. Para mais informações, visite a seção Integração avançada.
<?php
// SDK de Mercado Pago
require __DIR__ . '/vendor/autoload.php';
// Configura credenciais
MercadoPago\SDK::setAccessToken('PROD_ACCESS_TOKEN');
// Cria um objeto de preferência
$preference = new MercadoPago\Preference();
// Cria um item na preferência
$item = new MercadoPago\Item();
$item->title = 'Meu produto';
$item->quantity = 1;
$item->unit_price = 75.56;
$preference->items = array($item);
$preference->save();
?>
// SDK de Mercado Pago
const mercadopago = require ('mercadopago');
// Configura credenciais
mercadopago.configure({
access_token: 'PROD_ACCESS_TOKEN'
});
// Cria um objeto de preferência
let preference = {
items: [
{
title: 'Meu produto',
unit_price: 100,
quantity: 1,
}
]
};
mercadopago.preferences.create(preference)
.then(function(response){
// Este valor substituirá a string "<%= global.id %>" no seu HTML
global.id = response.body.id;
}).catch(function(error){
console.log(error);
});
// SDK de Mercado Pago
import com.mercadopago.MercadoPago;
// Configura credenciais
MercadoPago.SDK.setAccessToken("PROD_ACCESS_TOKEN");
// Cria um objeto de preferência
Preference preference = new Preference();
// Cria um item na preferência
Item item = new Item();
item.setTitle("Meu produto")
.setQuantity(1)
.setUnitPrice((float) 75.56);
preference.appendItem(item);
preference.save();
# SDK de Mercado Pago
require 'mercadopago.rb'
# Configura credenciais
$mp = MercadoPago.new('PROD_ACCESS_TOKEN')
# Cria um objeto de preferência
preference_data = {
"items": [
{
"title": "Meu produto",
"unit_price": 100,
"quantity": 1
}
]
}
preference = $mp.create_preference(preference_data)
# Este valor substituirá a string "<%= @preference_id %>" no seu HTML
@preference_id = preference["response"]["id"]
// SDK de Mercado Pago
using MercadoPago;
// Configura credenciais
MercadoPago.SDK.AccessToken = "PROD_ACCESS_TOKEN";
// Cria um objeto de preferência
Preference preference = new Preference();
// Cria um item na preferência
preference.Items.Add(
new Item()
{
Title = "Meu produto",
Quantity = 1,
CurrencyId = CurrencyId.ARS,
UnitPrice = (decimal)75.56
}
);
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": "Meu produto",
"quantity": 1,
"unit_price": 75.76
}
]
}'
2. Adicione o checkout ao seu site
Por último, adicione o seguinte código para mostrar o botão de pagamento do seu Checkout Pro onde você quiser que ele apareça.
<script
src="https://www.mercadopago.com.ar/integrations/v1/web-payment-checkout.js"
data-preference-id="<?php echo $preference->id; ?>">
</script>
<script
src="https://www.mercadopago.com.ar/integrations/v1/web-payment-checkout.js"
data-preference-id='<%= global.id %>'>
</script>
<script
src="https://www.mercadopago.com.ar/integrations/v1/web-payment-checkout.js"
data-preference-id="${preference.id}">
</script>
<script
src="https://www.mercadopago.com.ar/integrations/v1/web-payment-checkout.js"
data-preference-id="<%= @preference_id %>">
</script>
<script
src="https://www.mercadopago.com.ar/integrations/v1/web-payment-checkout.js"
data-preference-id="@Html.DisplayFor(model => model.id)">
</script>
Excelente! Você concluiu sua integração.
Clique no link dentro do seu site e teste a integração do seu Checkout Pro.