Installments without card - Integration configuration - Mercado Pago Developers
Which documentation are you looking for?

Do not know how to start integrating? 

Check the first steps

Installments without card

Mercado Credits is Mercado Pago’s financing method that allows paying in installments without having a card.

With this line of credit, administered by Mercado Pago, the payment is credited in full to the seller's account, while the customer can choose to pay in up to 12 fixed monthly installments, no card needed. The user just has to enter their Mercado Pago account (or create one), determine their available limit, and choose how many installments they want to pay in.

In addition to the options available in this documentation, it is also possible to configure installments without card using the Wallet Brick. Check Default rendering documentation of Wallet for more details.

Follow the steps below to offer installments without card in your store.


To perform a Card Payment Brick integration, you must meet the requirements listed below.

Mercado Pago or Mercado Libre seller accountTo integrate you need a seller account on Mercado Pago or Mercado Libre. If not, click here to create.
ApplicationApplications are the different integrations in one or more stores. You can create an application for each solution you implement to keep everything organized and on track for easier management. Check Your integrations for more information on how to create an application.
CredentialsUnique passwords with which we identify an integration in your account. To perform the integrations, you will need the Public key and the Access Token. Click here for more information.
Install the Mercado Pago SDKInstall the official SDKs to simplify your integration with our APIs. For more information, click here.

If all prerequisites have been met, follow the next steps to integrate installments without credit card.

Integration configuration

Create preference


Preferences are sets of information about a product and/or service that allow you to define the name, payment method, as well as other settings related to the defined payment flow.

The first step to configure payments with Mercado Crédito is to create the preference. To do so, send a POST with the purpose parameter and the onboarding_credits value to the endpoint /checkout/preferences and execute the request or, if you prefer, use the SDK below.

// Create a preference object
$preference = new MercadoPago\Preference();

// Create an item in the preference
$item = new MercadoPago\Item();
$item->title = 'My product';
$item->quantity = 1;
$item->unit_price = 75;
$preference->items = array($item);
$preference->purpose = 'onboarding_credits';

// Create a preference object
let preference = {
items: [
title: 'My product',
unit_price: 100,
quantity: 1,
purpose: 'onboarding_credits'

.then(function(response){ =;

// Create a preference object
PreferenceClient client = new PreferenceClient();

// Create an item in the preference
PreferenceItemRequest item =
.title("My product")
.unitPrice(new BigDecimal("75"))

List<PreferenceItemRequest> items = new ArrayList<>();

PreferenceRequest request =


# Create a preference object
preference_data = {
items: [
title: 'My product',
unit_price: 100,
quantity: 1
purpose: 'onboarding_credits'
preference_response = sdk.preference.create(preference_data)
preference = preference_response[:response]

# This value will replace the string "<%= @preference_id %>" in your HTML
@preference_id = preference['id']

// Create the preference request object
var request = new PreferenceRequest
Items = new List<PreferenceItemRequest>
new PreferenceItemRequest
Title = "My product,
quantity = 1,
CurrencyId = "BRL",
UnitPrice = 75m,
Purpose = "onboarding_credits",
// Create the preference
var client = new PreferenceClient();
Preference preference = await client.CreateAsync(request);

preference_data = {
"items": [
"title": "My product",
"unit_price": 100,
"quantity": 1
"purpose": "onboarding_credits"

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

curl -X POST \
  '' \
  -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"


Add checkout


After creating the preference in the backend, it is necessary to install the Mercado Pago frontend SDK to the project to add the payment button.

The installation is done in two steps: including the Mercado Pago SDK to the project with its configured credentials and initiating the checkout from the preference generated previously.

  1. To include the MercadoPago.js SDK, add the following to the project's HTML or install it via NPM as indicated in the examples below.
  <script src=""></script>

npm install @mercadopago/sdk-js


Next, initialize the integration by setting your public key using the following code.

  const mp = new MercadoPago("YOUR_PUBLIC_KEY");

import { loadMercadoPago } from "@mercadopago/sdk-js";

await loadMercadoPago();
const mp = new window.MercadoPago("YOUR_PUBLIC_KEY");


Once this is done, you need to create a container to define the location where the button will be inserted on the screen. The container is created by inserting an element into the HTML code of the page where the component will be rendered.

The value displayed below in the ID property is just an example and can be changed, but it must always match the ID indicated in the rendering step.
<div id="wallet_container"></div>

  1. After completing the previous step, initialize your checkout using the ID of the preference previously created with the identifier of the element where the button should be displayed.
mp.bricks().create("wallet", "wallet_container", {
  initialization: {
    preferenceId: "<PREFERENCE_ID>",
  customization: {
    texts: {
      valueProp: "convenience",


Done! After completing the steps described above, the payment button will be displayed on the screen and you will have finished the integration. Follow the steps below to explain to your customers how Mercado Crédito works.

  1. Create an account or sign in to Mercado Pago. If you use Mercado Livre, you already have this account!
  2. Select Mercado Crédito and choose how many times you want to pay
  3. Pay the installments every month as you prefer, in the Mercado Pago app.