Cuotas sin tarjeta - Configuración de la integración - Mercado Pago Developers

Pagos en cuotas sin tarjeta

Mercado Crédito es el método de financiación de Mercado Pago que permite pagar en cuotas sin tarjeta.

Al ofrecer esta opción en tu tienda, tus clientes podrán comprar un producto hoy y pagarlo después en cuotas. Para tu negocio, la aprobación de la compra es inmediata y está garantizada, se te acredita la totalidad por adelantado y tus clientes nos pagan después.

En esta guía encontrarás los pasos necesarios para ofrecer cuotas sin tarjeta en tu tienda.

Requisitos previos

Para realizar la integración es importante cumplir con los requisitos que se muestran a continuación.

RequisitosDescripción
Cuenta de vendedor de Mercado Pago o Mercado LibrePara integrar necesitas una cuenta de vendedor en Mercado Pago o Mercado Libre. Si no, haz clic aquí para crear.
AplicaciónLas aplicaciones son las diversas integraciones contenidas en una o varias tiendas. Puedes crear una aplicación para cada solución que implementes a fin de tener todo organizado y mantener un control que facilite la gestión. Consulta Dashboard para obtener más información sobre cómo crear una aplicación.
Instalar el SDK de Mercado PagoInstale los SDK oficiales para simplificar su integración con nuestras APIs. Para obtener más información, haz clic aquí.

Si se cumplen todos los requisitos previos, podrás realizar la integración de pagos en cuotas sin tarjeta.

Configuración de integración

Crear preferencia

Server-Side

Las preferencias son conjuntos de información sobre un producto y/o servicio que te permiten definir el nombre, el método de pago y otros atributos necesarios para obtener la URL para iniciar el flujo de pago al finalizar la compra.

La primera etapa para configurar los pagos con Mercado Crédito es la creación de la preferencia. Para esto, envía un POST con el parámetro purpose y el valor onboarding_credits al endpoint /checkout/preferences y ejecuta la solicitud o, si lo prefieres, utiliza uno de los SDKs indicados a continuación.

          
<?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 = 'onboarding_credits';
$preference->save();
?>

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

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

        
          
// Crea un objeto de preferencia
PreferenceClient client = new PreferenceClient();

// Crea un ítem en la preferencia
PreferenceItemRequest item =
   PreferenceItemRequest.builder()
       .title("Mi producto")
       .quantity(1)
       .unitPrice(new BigDecimal("75"))
       .build();

List<PreferenceItemRequest> items = new ArrayList<>();
items.add(item);

PreferenceRequest request =
   PreferenceRequest.builder().items(items).purpose("onboarding_credits").build();

client.create(request);

        
          
sdk = Mercadopago::SDK.new('ENV_ACCESS_TOKEN')
# Crea un objeto de preferencia
preference_data = {
  items: [
    {
      title: 'Mi producto',
      unit_price: 100,
      quantity: 1
    }
  ],
  purpose: 'onboarding_credits'
}
preference_response = sdk.preference.create(preference_data)
preference = preference_response[:response]

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

        
          
// Crea el objeto de request de la preferencia
var request = new PreferenceRequest
{
    Items = new List<PreferenceItemRequest>
    {
        new PreferenceItemRequest
        {
            Title = "Mi producto",
            Quantity = 1,
            CurrencyId = "ARS",
            UnitPrice = 75m,
        },
    },
    Purpose = "onboarding_credits",
};
// Crea la preferencia
var client = new PreferenceClient();
Preference preference = await client.CreateAsync(request);

        
          
preference_data = {
    "items": [
        {
            "title": "Mi producto",
            "unit_price": 100,
            "quantity": 1
        }
    ],
    "purpose": "onboarding_credits"
}

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
        }
    ],
    "purpose": "onboarding_credits"
}'

        

Añadir botón al checkout

Client-Side

Con la preferencia creada, se debe exhibir el botón de pago que permitirá al comprador utilizar Mercado Crédito para pagar. Para exhibir el botón de pago, inserte el siguiente código directamente en su proyecto.

html

<div class="cho-container"></div>
<script src="https://sdk.mercadopago.com/js/v2"></script>
<script>
  const mp = new MercadoPago('PUBLIC_KEY');

  mp.checkout({
    preference: {
      id: 'YOUR_PREFERENCE_ID'
    },
    render: {
      container: '.cho-container',
      label: 'Hasta 12 cuotas sin tarjeta con Mercado Pago',
      type: 'credits',
    }
  });
</script>

Al ingresar este código, debería ver un botón similar al ejemplo ilustrado a continuación.

cuotas sin tarjeta

Ejemplo del flujo de pago

ejemplo flujo

Sugerencias y buenas prácticas

Para ofrecer la mejor experiencia a tus compradores usando Mercado Crédito, te sugerimos:

  • Usar mayúsculas en las iniciales de la marca: Mercado Pago

iniciales

  • Mantener el logo de Mercado Pago

logo

  • Mantener la propuesta de valor de cuotas sin tarjeta

propuesta

  • Mantener la alineación y los espacios entre los elementos del botón

alineación

Para explicar mejor a tus clientes cómo funciona Mercado Crédito, puedes compartirles estos pasos a continuación.

  1. Crea una cuenta o ingresa en Mercado Pago. Si usas Mercado Libre, ¡ya tienes cuenta!

  2. Elige Mercado Crédito y la cantidad de cuotas en las que quieres pagar.

  3. ¡Listo! Después paga mes a mes tus cuotas desde la app de Mercado Pago.