Receba pagamentos com a carteira do Mercado Pago
Adicione na sua integração o Checkout Pro modo carteira, para que você receba pagamentos somente de usuários cadastrados no Mercado Pago, com seus cartões e saldo disponível.
Isto significa que seus clientes têm mais formas de te pagar e podem ter acesso aos melhores benefícios, sem mudar a dinâmica da sua API de Checkout.
Benefícios da carteira do Mercado Pago
Seus clientes podem te pagar com mais meios de pagamento e mais rapidamente:
- Com cartões já salvos nas suas contas Mercado Pago, poupando o esforço de digitar as informações de um cartão do zero. Eles também têm seus endereços salvos, o que simplifica todo o processo de preenchimento.
- Com saldo disponível no Mercado Pago, o dinheiro está pronto para ser usado na hora, em 1 clique.
Seus clientes podem pagar em até 12 vezes no boleto, com parcelamento financiado pelo Mercado Crédito.
A conversão do seu Checkout melhora ao oferecer meios de pagamento mais dinâmicos e fáceis de usar.
Melhora a aprovação dos seus pagamentos com menos risco de fraude.
Como adicionar a carteira no seu site
Você deve integrar o Checkout Pro configurado como modo carteira para adicionar a carteira do Mercado Pago no seu site.
Para integrá-lo, você deve gerar a preferência de pagamento com as informações do produto ou serviço que quer oferecer e adicionar a opção de pagamento no seu site.
Passos para integrar a carteira
1. Gere sua preferência
Server-Side
Para começar, você precisa gerar sua preferência de pagamento pelo seu backend com a SDK do Mercado Pago que você usou na sua API de Checkout.
<?php
// 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->purpose = 'wallet_purchase';
$preference->save();
?>
O modo carteira funciona adicionando o atributo purpose na preferência.
// Cria um objeto de preferência
let preference = {
items: [
{
title: 'Meu produto',
unit_price: 100,
quantity: 1,
}
],
purpose: 'wallet_purchase'
};
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);
});
O modo carteira funciona adicionando o atributo purpose na preferência.
// 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.setPurpose("wallet_purchase");
preference.save();
O modo carteira funciona adicionando o atributo purpose na preferência.
# Cria um objeto de preferência
preference_data = {
"items": [
{
"title": "Meu produto",
"unit_price": 100,
"quantity": 1
}
],
"purpose": "wallet_purchase"
}
preference = $mp.create_preference(preference_data)
# Este valor substituirá a string "<%= @preference_id %>" no seu HTML
@preference_id = preference["response"]["id"]
O modo carteira funciona adicionando o atributo purpose na preferência.
// 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.BRL,
UnitPrice = (decimal)75
}
);
preference.Purpose = "wallet_purchase"
preference.Save();
O modo carteira funciona adicionando o atributo purpose na preferência.
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
}
],
"purpose": "wallet_purchase"
}'
2. Adicione o checkout ao seu site
Client-Side
Depois, do seu frontend, adicione o seguinte código para exibir o botão de pagamento do Checkout Pro modo carteira 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; ?>"
data-button-label="Paga com Mercado Pago"
data-button-type="wallet">
</script>
<script
src="https://www.mercadopago.com.ar/integrations/v1/web-payment-checkout.js"
data-preference-id="<%= global.id %>"
data-button-label="Paga com Mercado Pago"
data-button-type="wallet">
</script>
<script
src="https://www.mercadopago.com.ar/integrations/v1/web-payment-checkout.js"
data-preference-id="${preference.id}"
data-button-label="Paga com Mercado Pago"
data-button-type="wallet">
</script>
<script
src="https://www.mercadopago.com.ar/integrations/v1/web-payment-checkout.js"
data-preference-id="<%= @preference_id %>"
data-button-label="Paga com Mercado Pago"
data-button-type="wallet">
</script>
<script
src="https://www.mercadopago.com.ar/integrations/v1/web-payment-checkout.js"
data-preference-id="@Html.DisplayFor(model => model.id)"
data-button-label="Paga com Mercado Pago"
data-button-type="wallet">
</script>
Para mais informações sobre cada atributo, confira a Referência de API.
Pronto! você já tem a carteira do Mercado Pago integrada no seu site.
O modo carteira funciona adicionando o atributo purpose na preferência.