Create preference

It is possible to create Preferences using the SDK below. For details on request parameters, check the Create preference API.

const client = new MercadoPagoConfig({ accessToken: 'access_token', options: { timeout: 5000 } });

const preference = new Preference(client);

preference.create({ body: {
	items: [
		{
			id: '<ID>',
			title: '<title>',
			quantity: 1,
			unit_price: 100
		}
	],
} }).then(console.log).catch(console.log);

Search preferences

You can find all the preferences information generated through specific filters or by a specific date range using the SDK below. For details of the request parameters, access the Search Preferences API.

const client = new MercadoPagoConfig({ accessToken: 'access_token', options: { timeout: 5000 } });

const preference = new Preference(client);

preference.search({ options: {
  sponsor_id: '0',
  external_reference: '',
  site_id: 'MLA',
  marketplace: 'NONE'
},
}).then((result) => console.log(result))
  .catch((error) => console.log(error));

Get preference

You can get all payment information for a product or service with the desired preference ID using the SDK below. For details on the request parameters, access the Get Preference API.

const client = new MercadoPagoConfig({ accessToken: 'access_token', options: { timeout: 5000 } });
const preference = new Preference(client);

preference.get({ preferenceId: '123456789' })
.then(console.log).catch(console.log);

Update preference

You can update the details of a payment preference using the preference ID. For details of the request parameters, access the Update Preference API.

const client = new MercadoPagoConfig({ accessToken: 'access_token', options: { timeout: 5000 } });

const preference = new Preference(client);

preference.update({
	id: '123456789',
	updatePreferenceRequest: {
		items: [
			{
				id: '1234',
				title: 'Dummy Title',
				quantity: 1,
				unit_price: 100
			}
		],
	}
}).then(console.log).catch(console.log);

Associate Facebook Ads

You can associate the preference with a pixel to track the conversions of Facebook ads. To obtain details about the request parameters, consult the API Create Preference.

===
Add the following code in the preference and replace the <code>pixel_id</code> value with its identifier.
===
  // Create a preference object
var preference = {
  // Associate your Facebook Pixel
  tracks: [
        {
          type: "facebook_ad",
          values: {
            "pixel_id": 'PIXEL_ID'
          }
        }
      ]
  //...
};

Associate Google Ads

You can associate a tag with your preference for tracking Google Ads conversions. For details on request parameters, check the API Create Preference.

===
Add the code in the preference and replace the <code>CONVERSION\_ID</code> and <code>CONVERSION\_LABEL</code> values with the data from your tag.
===
// Configure your preference
var preference = {
 // Associate your tag
  tracks: [
        {
            type: "google_ad",
            values: {
              conversion_id: "CONVERSION_ID",
              conversion_label: "CONVERSION_LABEL"
            }
        }
      ]
  ...
};

Pagos

Reembolsos