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'

          
// SDK de Mercado Pago
 using MercadoPago.Config;

          
# SDK de Mercado Pago
import 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
sdk = Mercadopago::SDK.new('PROD_ACCESS_TOKEN')

          
// SDK de Mercado Pago
using MercadoPago.Config;

// Configura credenciais
MercadoPagoConfig.AccessToken = "PROD_ACCESS_TOKEN";

          
# SDK de Mercado Pago  
import mercadopago

# Configura credenciais
sdk = mercadopago.SDK("PROD_ACCESS_TOKEN")

1.3 Configure a preferência conforme seu produto ou serviço:

          
<?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;
$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);
preference.appendItem(item);
preference.save();

          
# SDK de Mercado Pago
require 'mercadopago'

# Configura credenciais
sdk = Mercadopago::SDK.new('PROD_ACCESS_TOKEN')

# Cria um objeto de preferência
preference_data = {
  items: [
    {
      title: 'Meu produto',
      unit_price: 75,
      quantity: 1
    }
  ]
}
preference_response = sdk.preference.create(preference_data)
preference = preference_response[:response]

# Este valor substituirá a string "<%= @preference_id %>" no seu HTML
@preference_id = preference['id']

          
// SDK de Mercado Pago
using MercadoPago.Config;
using MercadoPago.Client.Preference;
using MercadoPago.Resource.Preference;

// Configura credenciais
MercadoPagoConfig.AccessToken = "PROD_ACCESS_TOKEN";

// Cria o objeto de request da preferência
var request = new PreferenceRequest
{
    Items = new List<PreferenceItemRequest>
    {
        new PreferenceItemRequest
        {
            Title = "Meu produto",
            Quantity = 1,
            CurrencyId = "CLP",
            UnitPrice = 75m,
        },
    },
};

// Cria a preferência usando o client
var client = new PreferenceClient();
Preference preference = await client.CreateAsync(request);

          
# SDK de Mercado Pago
import mercadopago

# Configura credenciais
sdk = mercadopago.SDK("PROD_ACCESS_TOKEN")

# Cria um objeto de preferência
preference_data = {
    "items": [
        {
            "title": "My Item",
            "quantity": 1,
            "unit_price": 75
        }
    ]
}

preference_response = sdk.preference().create(preference_data)
preference = preference_response["response"]

          
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
        }
    ]
}'

Importante

O valor de unit_price deve ser um número inteiro.

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.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>

          
<script
  src="https://www.mercadopago.cl/integrations/v1/web-payment-checkout.js"
  data-preference-id="{{ preference_id }}">
</script>

Importante

Esta documentação utiliza a antiga versão da biblioteca. Para ver a versão nova, vá para a seção de Integre o Checkout Pro com MercadoPago.js V2 .

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

Previous requirements

Tests