Integração do Checkout Pro - Checkout Pro - Mercado Pago Developers
Developers
Referência API
Suporte
Entrar

    Inicio

    Começando

    Pagamentos online

    Checkout Pro

    Checkout API

    Link de pagamento

    Assinaturas

    Marketplace

    Mobile Checkout

    Web Tokenize Checkout

    Pagamentos presenciais

    Código QR

    Mercado Pago Point

    Plugins e plataformas

    WooCommerce

    Prestashop

    Magento 2

    Shopify

    Tiendanube

    VTEX

    SDKs

    Notificações

    Webhooks

    IPN

    Gerenciamento de conta

    Requisitos para ir à produção

    Obter pagamentos

    Relatórios

    Devoluções e cancelamentos

    Gestão de estornos

    Melhora a aprovação

    Recursos

    Localização

    Changelog

    Status

NESTA PÁGINA

Sugerir alterações
Ajude-nos a melhorar a documentação
Você viu informações equivocadas, gostaria que explicássemos algo a mais ou que melhorássemos nossos manuais? Deixe suas sugestões no GitHub.

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

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

  2. 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
  • node
  • java
  • ruby
  • csharp
          
<?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
  • node
  • java
  • ruby
  • csharp
          
<?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
  • node
  • java
  • ruby
  • csharp
  • curl
          
<?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.

  • php
  • node
  • java
  • ruby
  • csharp
          
<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.

RECOMENDADO

Aceite a carteira Mercado Pago

Permite pagamentos somente de usuários cadastrados no Mercado Pago, com cartão e saldo disponível.

Essas informações foram úteis?

Mercado Pago ofrece servicios de pago y no está autorizado por el Banco Central a operar como entidad financiera. Los fondos acreditados en cuentas de pago no constituyen depósitos en una entidad financiera ni están garantizados conforme legislación aplicable a depósitos en entidades financieras. Copyright © 2021 MercadoLibre S.R.L.

Termos e condiçõesComo cuidamos da sua privacidade
Partners Mercado Pago

Al navegar en este sitio aceptás las cookies que utilizamos para mejorar tu experiencia. Más información.