Socket
Socket
Sign inDemoInstall

mercadopago

Package Overview
Dependencies
8
Maintainers
12
Versions
78
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

mercadopago

Mercadopago SDK for Node.js


Version published
Maintainers
12
Weekly downloads
11,727
decreased by-31.71%

Weekly downloads

Readme

Source

SDK Node Mercado Pago

Mercado Pago SDK for NodeJS

NPM Version Downloads License

This library provides developers with a simple set of bindings to help you integrate Mercado Pago API to a website and start receiving payments.

💡 Requirements

The SDK Supports NodeJS version 12 or higher.

📲 Installation

First time using Mercado Pago? Create your Mercado Pago account, if you don’t have one already.

  1. Install NodeJS SDK for MercadoPago running in command line:
$ npm install --save mercadopago
  1. Copy the access_token in the credentials section of the page and replace YOUR_ACCESS_TOKEN with it.

That's it! Mercado Pago SDK has been successfully installed.

🌟 Getting Started

Simple usage looks like:

// Step 1: Import the parts of the module you want to use
import { MercadoPagoConfig, Payment } from 'mercadopago';

// Step 2: Initialize the client object
const client = new MercadoPagoConfig({ accessToken: 'access_token', options: { timeout: 5000, idempotencyKey: 'abc' } });

// Step 3: Initialize the API object
const payment = new Payment(client);

// Step 4: Create the request object
const body = {
	transaction_amount: 12.34,
	description: '<DESCRIPTION>',
	payment_method_id: '<PAYMENT_METHOD_ID>',
	payer: {
		email: '<EMAIL>'
	},
};

// Step 5: Create request options object - Optional
const requestOptions = {
	idempotencyKey: '<IDEMPOTENCY_KEY>',
};

// Step 6: Make the request
payment.create({ body, requestOptions }).then(console.log).catch(console.log);

Step 1: Import the parts of the module you want to use

Import MercadoPagoConfig and API objects from the MercadoPago module.

import { MercadoPagoConfig, Payment } from 'mercadopago';

Step 2: Initialize the client object

Initialize the client object, passing the following:

  • accessToken: Application's private key.
  • options: These are optional fields,
    • timeout: Are the timeout of requests
    • idempotencyKey: Idempotency Is for retrying requests without accidentally performing the same operation twice

For example:

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

Step 3: Initialize the API object

Initialize the API object you want to use, passing the client object from the previous step.

const payment = new Payment(client);

Step 4: Create the request object

Create a the request object. For example, for a request to the /v1/payments endpoint:

const body = {
	transaction_amount: 12.34,
	description: '<DESCRIPTION>',
	payment_method_id: '<PAYMENT_METHOD_ID>',
	payer: {
		email: '<EMAIL>'
	},
};

Step 5: Make the request

Use the API object's method to make the request. For example, to make a request to the /v1/payments endpoint using the payment object:

payment.create({ body }).then(console.log).catch(console.log);

📚 Documentation

Visit our Dev Site for further information regarding:

Check our official code reference to explore all available functionalities.

🤝 Contributing

All contributions are welcome, ranging from people wanting to triage issues, others wanting to write documentation, to people wanting to contribute with code.

Please read and follow our contribution guidelines. Contributions not following these guidelines will be disregarded. The guidelines are in place to make all of our lives easier and make contribution a consistent process for everyone.

Patches to version 1.x.x

Since the release of version 2.0.0, version 1 is deprecated and will not be receiving new features, only bug fixes. If you need to submit PRs for that version, please do so by using develop-v1 as your base branch.

❤️ Support

If you require technical support, please contact our support team at our developers site: English / Portuguese / Spanish

🏻 License

MIT license. Copyright (c) 2023 - Mercado Pago / Mercado Libre 
For more information, see the LICENSE file.

Keywords

FAQs

Last updated on 23 Feb 2024

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc