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