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?

Integration

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:

Por favor considere que é necessário configurar as 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
        }
    ]
}'

Aceite pagamentos apenas de usuários cadastrados

Se quiser aceitar pagamentos apenas de usuários cadastrados, com cartão e saldo no Mercado Pago, entre nesta seção para mais informações.

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>

Importante

Não esqueça de acessar de outro navegador ou de encerrar a sessão da sua conta do Mercado Pago antes de fazer os testes. Você não pode pagar com a mesma conta que criou o formulário de pagamento.

Excelente! Você concluiu sua integração.

Clique no link dentro do seu site e teste a integração do seu Checkout Pro.

Exemplos para download

Checkout Pro

Disponibilizamos exemplos completos de integração no GitHub para PHP ou NodeJS para que você possa fazer o download imediatamente.

Próximos passos

RECOMENDADO

Teste sua integração

Confira se está tudo em ordem na sua integração com os usuários de teste.