Suma la billetera de Mercado Pago - Checkout API - Mercado Pago Developers
Developers
Referencia de API
Soporte
Ingresar

    Inicio

    Empieza por aquí

    Cobros online

    Checkout Pro

    Checkout Transparente

    Link de pago

    Suscripciones

    Marketplace

    Mobile Checkout

    Web Tokenize Checkout

    Pagos presenciales

    Código QR

    Mercado Pago Point

    Plugins y plataformas

    WooCommerce

    Prestashop

    Magento 2

    Shopify

    VTEX

    Loja Integrada

    Nuvemshop

    iSet

    Linx Commerce

    Wix

    SDKs

    Notificaciones

    Webhooks

    IPN

    Gestión de cuenta

    Requisitos para ir a producción

    Obtener pagos

    Reportes

    Devoluciones y cancelaciones

    Gestión de contracargos

    Mejora la aprobación

    Recursos

    Localización

    Changelog

    Status

EN ESTA PÁGINA

Sugiere cambios
Ayúdanos a mejorar la documentación
¿Viste información errónea, te gustaría que expliquemos algo más o que mejoremos nuestras guías? Déjanos tus sugerencias en GitHub.

Recibe pagos con la billetera de Mercado Pago

Agrega en tu integración el Checkout Pro modo billetera, para que recibas pagos únicamente de usuarios registrados en Mercado Pago, con sus tarjetas y dinero disponible.

Esto significa que tus clientes tienen más formas de pagarte y pueden acceder a mejores beneficios, sin alterar la dinámica de tu Checkout API.

Checkout-Wallet

Beneficios de la billetera de Mercado Pago

  • Tus clientes pueden pagarte con más medios de pago y de forma más rápida:

    • Con tarjetas de crédito o débito ya guardadas en sus cuentas de Mercado Pago, ahorrando el esfuerzo de ingresar una tarjeta desde el comienzo. También tienen sus direcciones guardadas, lo que simplifica todo el proceso de carga.
    • Con dinero disponible en Mercado Pago tienen su dinero listo para ser usado en el momento, en tan solo 1 click.
  • Tus clientes pueden pagarte en hasta 12 cuotas sin usar tarjeta de crédito, siendo financiados por Mercado Crédito.

  • La conversión de tu Checkout mejora al ofrecer medios de pago más dinámicos y fáciles de usar.

  • Mejora la aprobación de tus pagos con menor riesgo de fraude.

Cómo sumar la billetera en tu sitio

Necesitas integrar Checkout Pro configurado como modo billetera para agregar la billetera de Mercado Pago en tu sitio.

Para integrarlo, tienes que generar la preferencia de pago con la información del producto o servicio que quieras ofrecer y agregar la opción de pago en tu sitio.

Pasos para integrar la billetera

      1. Genera tu preferencia

Server-Side

Para comenzar, tienes que generar tu preferencia de pago desde tu backend con la SDK de Mercado Pago que utilizaste en tu Checkout API.

  • php
  • node
  • java
  • ruby
  • csharp
  • curl

El modo billetera funciona agregando el atributo purpose en la preferencia.

          
<?php
// Crea un objeto de preferencia
$preference = new MercadoPago\Preference();

// Crea un ítem en la preferencia
$item = new MercadoPago\Item();
$item->title = 'Mi producto';
$item->quantity = 1;
$item->unit_price = 75;
$preference->items = array($item);
$preference->purpose = 'wallet_purchase';
$preference->save();
?>

        

El modo billetera funciona agregando el atributo purpose en la preferencia.

          
// Crea un objeto de preferencia
let preference = {
  items: [
    {
      title: 'Mi producto',
      unit_price: 100,
      quantity: 1,
    }
  ],
  purpose: 'wallet_purchase'
};

mercadopago.preferences.create(preference)
.then(function(response){
// Este valor reemplazará el string "<%= global.id %>" en tu HTML
  global.id = response.body.id;
}).catch(function(error){
  console.log(error);
});

        

El modo billetera funciona agregando el atributo purpose en la preferencia.

          
// Crea un objeto de preferencia
Preference preference = new Preference();

// Crea un ítem en la preferencia
Item item = new Item();
item.setTitle("Mi producto")
    .setQuantity(1)
    .setUnitPrice((float) 75);
preference.appendItem(item);
preference.setPurpose("wallet_purchase");
preference.save();

        

El modo billetera funciona agregando el atributo purpose en la preferencia.

          
# Crea un objeto de preferencia
preference_data = {
  "items": [
    {
      "title": "Mi producto",
      "unit_price": 100,
      "quantity": 1
    }
  ],
  "purpose": "wallet_purchase"
}
preference = $mp.create_preference(preference_data)

# Este valor reemplazará el string "<%= @preference_id %>" en tu HTML
@preference_id = preference["response"]["id"]

        

El modo billetera funciona agregando el atributo purpose en la preferencia.

          
// Crea un objeto de preferencia
Preference preference = new Preference();

// Crea un ítem en la preferencia
preference.Items.Add(
  new Item()
  {
    Title = "Mi producto",
    Quantity = 1,
    CurrencyId = CurrencyId.BRL,
    UnitPrice = (decimal)75
  }
);
preference.Purpose = "wallet_purchase"
preference.Save();

        

El modo billetera funciona agregando el atributo purpose en la preferencia.

          
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": "Mi producto",
            "quantity": 1,
            "unit_price": 75
        }
    ],
    "purpose": "wallet_purchase"
}'

        

      2. Suma el checkout a tu sitio

Client-Side

Luego, desde tu frontend, agrega el siguiente código para mostrar el botón de pago de Checkout Pro modo billetera en el lugar que quieras que aparezca.

  • 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; ?>"
  data-button-label="Pagar con 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="Pagar con 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="Pagar con 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="Pagar con 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="Pagar con Mercado Pago"
  data-button-type="wallet">
</script>

        

Para más información sobre cada atributo, consulta la Referencia de API.

¡Y listo! Ya tienes integrada la billetera de Mercado Pago en tu sitio.

Importante
Para probarlo, no te olvides de acceder desde otro navegador o cerrar la sesión de tu cuenta de Mercado Pago ya que no puedes pagarte a ti mismo.

Próximos pasos

RECOMENDADO

Integración avanzada de Checkout Pro

Optimiza la integración de tu billetera para mejorar la gestión de tus ventas.

RECOMENDADO

Prueba la billetera

Revisa que esté todo bien en tu integración con los usuarios de prueba.

¿Te resultó útil esta información?

Copyright © 2021 MercadoPago.com Representações LTDA. / CNPJ n.º 10.573.521/0001-91 / Av. das Nações Unidas, nº 3.003, Bonfim, Osasco/SP - CEP 06233-903

Términos y condicionesCómo cuidamos tu privacidad
Partners Mercado Pago

Ao navegar neste site, você aceita os cookies que usamos para melhorar sua experiência. Mais informações.