feat: add PreApprovalPlan, AdvancedPayment, Invoice, DisbursementRefund and Chargeback clients (v3.2.0)

CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+This project follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
+and [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [3.2.0] - 2026-05-27
+
+### Added
+
+- **PreApprovalPlan**: subscription plan template management — create, get, update, search
+  (`POST/GET/PUT /preapproval_plan`). Enables reusable billing templates for subscriptions.
+
+- **AdvancedPayment**: marketplace split-payment management — create, get, search, capture, cancel,
+  updateReleaseDate (`POST/GET/PUT /v1/advanced_payments`). Enables distributing a single
+  payment among multiple sellers.
+
+- **Invoice**: retrieval and search of subscription billing invoices — get, search
+  (`GET /authorized_payments`). Enables monitoring of billing cycles generated by preapprovals.
+
+- **DisbursementRefund**: refunds for split-payment disbursements — createAll, create
+  (`POST /v1/advanced_payments/{id}/refunds`). Enables partial and full refunds of individual
+  disbursements within an advanced payment.
+
+- **Chargeback**: read-only access to payment dispute records — get, search
+  (`GET /v1/chargebacks`). Enables monitoring and response to cardholder disputes.

pom.xml

@@ -4,7 +4,7 @@
 
     <groupId>com.mercadopago</groupId>
     <artifactId>sdk-java</artifactId>
-    <version>3.1.0</version>
+    <version>3.2.0</version>
     <packaging>jar</packaging>
 
     <name>Mercadopago SDK</name>

src/main/java/com/mercadopago/MercadoPagoConfig.java

@@ -35,7 +35,7 @@
  */
 public class MercadoPagoConfig {
 
-  public static final String CURRENT_VERSION = "3.1.0";
+  public static final String CURRENT_VERSION = "3.2.0";
 
   /** Internal MercadoPago product identifier sent in every API request for analytics. */
   public static final String PRODUCT_ID = "BC32A7VTRPP001U8NHJ0";

src/main/java/com/mercadopago/client/advancedpayment/AdvancedPaymentCancelRequest.java

@@ -0,0 +1,9 @@
+package com.mercadopago.client.advancedpayment;
+
+import lombok.Getter;
+
+/** Request to cancel an advanced payment (sets {@code status} to {@code "cancelled"}). */
+@Getter
+public class AdvancedPaymentCancelRequest {
+  private final String status = "cancelled";
+}

src/main/java/com/mercadopago/client/advancedpayment/AdvancedPaymentCaptureRequest.java

@@ -0,0 +1,11 @@
+package com.mercadopago.client.advancedpayment;
+
+import lombok.Builder;
+import lombok.Getter;
+
+/** Request to capture an advanced payment (sets {@code capture} to {@code true}). */
+@Getter
+@Builder
+public class AdvancedPaymentCaptureRequest {
+  private final boolean capture = true;
+}