// the find
mercadopago/sdk-nodejs
Mercado Pago's Official Node.js SDK
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.