finds.dev

mercadopago/sdk-java

Mercado Pago's Official Java SDK

View on GitHubHomepage ↗

★ 169JavaMITupdated Jun 2026

// the take

The official Java client for Mercado Pago, Latin America's dominant payments platform. If you're building e-commerce for Brazilian, Argentine, or Mexican markets, this is your only real option — Mercado Pago has ~40% of LATAM online payments volume and no serious alternative SDK exists for Java.

Per-request MPRequestOptions lets you override access token, timeouts, and headers without touching global state — good for multi-tenant marketplace apps. The MPHttpClient interface is a clean seam for swapping in OkHttp or your own instrumented client. Idempotency key support is first-class via custom headers, not bolted on. Actively maintained with dependabot and a CI pipeline that publishes to Maven Central on release.

Global mutable state via MercadoPagoConfig.setAccessToken() is a design smell that will bite you in multi-tenant or multi-threaded scenarios even though per-request overrides exist — the default path is still thread-unsafe. 169 stars for an official SDK from a company processing billions in transactions is a signal that most Java shops are calling the REST API directly rather than trusting this library. No async/reactive support — all calls are synchronous blocking, so you'll need to wrap everything yourself if you're on Spring WebFlux or any non-blocking stack. The docs are committed HTML javadoc in the repo itself, which is a maintenance anti-pattern.

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
169
Forks
56
Language
Java
License
MIT
Last commit
15 Jun 2026

// nearby

If sdk-java isn't quite it.

All repos →