Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/mercadopago/sdk-java/llms.txt

Use this file to discover all available pages before exploring further.

The Mercado Pago Java SDK gives your application a fully type-safe interface to the Mercado Pago REST APIs. It ships clients for every major resource — payments, orders, checkout preferences, subscriptions, card tokens, in-person Point payments, and more — all backed by a consistent builder pattern, automatic idempotency, and per-request configuration.

Introduction

Learn what the SDK covers, the requirements, and how it is structured.

Quickstart

Install the SDK, authenticate, and process your first payment in minutes.

Configuration

Configure global timeouts, logging, proxy, and custom HTTP clients.

API Reference

Full reference for every public class, method, and parameter.

​
What you can build

Payments

Create, capture, cancel, and refund payments via the Payments API.

Orders

Manage the full order lifecycle including transactions and refunds.

Checkout Preferences

Build Checkout Pro flows with redirect URLs and payment settings.

Subscriptions

Create and manage recurring billing with preapproval plans.

In-Person Payments

Accept card-present payments via Mercado Pago Point devices.

Webhooks

Validate incoming webhook signatures with HMAC-SHA256.

​
Quick install

Add the SDK to your Maven project and set your access token to start making API calls.
pom.xml
<dependency>
  <groupId>com.mercadopago</groupId>
  <artifactId>sdk-java</artifactId>
  <version>3.3.0</version>
</dependency>
Main.java
import com.mercadopago.MercadoPagoConfig;
import com.mercadopago.client.payment.PaymentClient;

MercadoPagoConfig.setAccessToken("APP_USR-...");
PaymentClient client = new PaymentClient();
You need a Mercado Pago account and an access token to use this SDK. Get your credentials from the Mercado Pago developer panel.

Build docs developers (and LLMs) love

Get started for freeTalk to us