finds.dev

mercadopago/sdk-nodejs

Mercado Pago's Official Node.js SDK

View on GitHubHomepage ↗

★ 480TypeScriptMITupdated Jun 2026

// the take

Official Node.js/TypeScript SDK for Mercado Pago, the dominant payment processor across Latin America (Argentina, Brazil, Mexico, etc.). If you're building e-commerce for LATAM markets, this is what you reach for — there's no serious alternative for MP's API surface. Not relevant if you're not targeting those markets.

Well-structured source: each API operation lives in its own directory with its own types file, so the codebase is navigable even without docs. TypeScript types are generated from the actual API contracts, not handwritten — you get autocomplete for payment method IDs and installment configs. E2E test suite covers real API flows (card token creation, 3DS orders, refunds), not just mocked unit tests. Idempotency key support is a first-class concept at the config level, not an afterthought bolted onto individual calls.

The README documents almost nothing except the Order API — if you need Payments, PreApproval, or Point (in-person POS), you're reading source files and the MP developer portal, not the SDK docs. No retry logic or backoff built into the HTTP client; network errors on payment creation in flaky mobile connections are your problem to handle. The new Order API and the legacy Payment API coexist with overlapping responsibilities and no guidance on which to use when — the migration path between them is undocumented in the repo. Stars-to-usage ratio is inverted: this SDK is used by a huge number of LATAM merchants, but 480 stars suggests most teams just npm-install it without ever visiting the repo.

We read the README, the directory tree and a key source file in June 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
480
Forks
129
Language
TypeScript
License
MIT
Last commit
11 Jun 2026

// nearby

If sdk-nodejs isn't quite it.

All repos →