Release 4.0.1

CHANGELOG.md

@@ -1,3 +1,19 @@
+### v4.0.1 (2026-01-19)
+* * * 
+
+### New Parameters:
+* `applicable_item_price_ids` has been added to Coupon#CouponListRequest.
+* `applicable_item_price_ids` has been added to Export#CouponRequest.
+
+### New Enums: 
+* `Twikey` has been added to GatewayEnum.
+
+### Deleted Action: 
+* `move` action has been removed from the ItemPrice. 
+
+### New Features:
+* add util method for export and 'Time Machine' async handler.
+
 ### v4.0.0 (2026-01-13)
 * * *
 

build.gradle.kts

@@ -7,8 +7,8 @@ plugins {
 }
 
 group = "com.chargebee"
-version = "4.0.0"
-description = "Next-gen Java client library for ChargeBee API"
+version = "4.0.1"
+description = "Java client library for ChargeBee"
 
 // Project metadata
 val projectUrl = "https://github.com/chargebee/chargebee-java"

src/main/java/com/chargebee/v4/models/card/Card.java

@@ -296,6 +296,8 @@ public enum Gateway {
 
     EZIDEBIT("ezidebit"),
 
+    TWIKEY("twikey"),
+
     NOT_APPLICABLE("not_applicable"),
 
     /** An enum member indicating that Gateway was instantiated with an unknown value. */

src/main/java/com/chargebee/v4/models/card/params/CardSwitchGatewayForCustomerParams.java

@@ -180,6 +180,8 @@ public enum Gateway {
 
     EZIDEBIT("ezidebit"),
 
+    TWIKEY("twikey"),
+
     /** An enum member indicating that Gateway was instantiated with an unknown value. */
     _UNKNOWN(null);
     private final String value;

src/main/java/com/chargebee/v4/models/card/params/UpdateCardForCustomerParams.java

@@ -537,6 +537,8 @@ public enum Gateway {
 
     EZIDEBIT("ezidebit"),
 
+    TWIKEY("twikey"),
+
     /** An enum member indicating that Gateway was instantiated with an unknown value. */
     _UNKNOWN(null);
     private final String value;

src/main/java/com/chargebee/v4/models/coupon/params/CouponListParams.java

@@ -95,6 +95,10 @@ public CurrencyCodeFilter currencyCode() {
       return new CurrencyCodeFilter("currency_code", this, queryParams);
     }
 
+    public ApplicableItemPriceIdsFilter applicableItemPriceIds() {
+      return new ApplicableItemPriceIdsFilter("applicable_item_price_ids", this, queryParams);
+    }
+
     public CouponListParams build() {
       return new CouponListParams(this);
     }
@@ -153,6 +157,13 @@ public static final class CurrencyCodeFilter extends StringFilter<CouponListBuil
       }
     }
 
+    public static final class ApplicableItemPriceIdsFilter extends StringFilter<CouponListBuilder> {
+      ApplicableItemPriceIdsFilter(
+          String fieldName, CouponListBuilder builder, Map<String, Object> params) {
+        super(fieldName, builder, params);
+      }
+    }
+
     public static final class SortBySortBuilder {
       private final String fieldName;
       private final CouponListBuilder builder;

src/main/java/com/chargebee/v4/models/customer/Customer.java

@@ -2284,6 +2284,8 @@ public enum Gateway {
 
       EZIDEBIT("ezidebit"),
 
+      TWIKEY("twikey"),
+
       NOT_APPLICABLE("not_applicable"),
 
       /** An enum member indicating that Gateway was instantiated with an unknown value. */

src/main/java/com/chargebee/v4/models/customer/params/CustomerCreateParams.java

@@ -1812,6 +1812,8 @@ public enum Gateway {
 
       EZIDEBIT("ezidebit"),
 
+      TWIKEY("twikey"),
+
       /** An enum member indicating that Gateway was instantiated with an unknown value. */
       _UNKNOWN(null);
       private final String value;
@@ -2689,6 +2691,8 @@ public enum Gateway {
 
       EZIDEBIT("ezidebit"),
 
+      TWIKEY("twikey"),
+
       /** An enum member indicating that Gateway was instantiated with an unknown value. */
       _UNKNOWN(null);
       private final String value;

src/main/java/com/chargebee/v4/models/customer/params/CustomerUpdatePaymentMethodParams.java

@@ -494,6 +494,8 @@ public enum Gateway {
 
       EZIDEBIT("ezidebit"),
 
+      TWIKEY("twikey"),
+
       /** An enum member indicating that Gateway was instantiated with an unknown value. */
       _UNKNOWN(null);
       private final String value;

src/main/java/com/chargebee/v4/models/export/params/ExportAddonsParams.java

@@ -45,7 +45,9 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.addon.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "addon[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[") ? "addon[" + key.replace("[", "][") : "addon[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }

src/main/java/com/chargebee/v4/models/export/params/ExportAttachedItemsParams.java

@@ -44,7 +44,11 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.attachedItem.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "attached_item[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[")
+                ? "attached_item[" + key.replace("[", "][")
+                : "attached_item[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }

src/main/java/com/chargebee/v4/models/export/params/ExportCouponsParams.java

@@ -44,7 +44,9 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.coupon.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "coupon[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[") ? "coupon[" + key.replace("[", "][") : "coupon[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }
@@ -73,6 +75,10 @@ public CurrencyCodeFilter currencyCode() {
       return new CurrencyCodeFilter("currency_code", this, filterParams);
     }
 
+    public ApplicableItemPriceIdsFilter applicableItemPriceIds() {
+      return new ApplicableItemPriceIdsFilter("applicable_item_price_ids", this, filterParams);
+    }
+
     public ExportCouponsBuilder coupon(CouponParams value) {
       this.coupon = value;
       return this;
@@ -88,6 +94,14 @@ public static final class CurrencyCodeFilter extends StringFilter<ExportCouponsB
         super(fieldName, builder, params);
       }
     }
+
+    public static final class ApplicableItemPriceIdsFilter
+        extends StringFilter<ExportCouponsBuilder> {
+      ApplicableItemPriceIdsFilter(
+          String fieldName, ExportCouponsBuilder builder, Map<String, Object> params) {
+        super(fieldName, builder, params);
+      }
+    }
   }
 
   public static final class CouponParams {

src/main/java/com/chargebee/v4/models/export/params/ExportCreditNotesParams.java

@@ -38,7 +38,11 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.creditNote.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "credit_note[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[")
+                ? "credit_note[" + key.replace("[", "][")
+                : "credit_note[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }

src/main/java/com/chargebee/v4/models/export/params/ExportCustomersParams.java

@@ -65,7 +65,9 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.customer.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "customer[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[") ? "customer[" + key.replace("[", "][") : "customer[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }
@@ -75,7 +77,11 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.relationship.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "relationship[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[")
+                ? "relationship[" + key.replace("[", "][")
+                : "relationship[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }

src/main/java/com/chargebee/v4/models/export/params/ExportDeferredRevenueParams.java

@@ -160,7 +160,9 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.invoice.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "invoice[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[") ? "invoice[" + key.replace("[", "][") : "invoice[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }
@@ -170,7 +172,11 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.subscription.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "subscription[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[")
+                ? "subscription[" + key.replace("[", "][")
+                : "subscription[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }
@@ -180,7 +186,9 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.customer.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "customer[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[") ? "customer[" + key.replace("[", "][") : "customer[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }
@@ -190,7 +198,11 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.relationship.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "relationship[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[")
+                ? "relationship[" + key.replace("[", "][")
+                : "relationship[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }

src/main/java/com/chargebee/v4/models/export/params/ExportDifferentialPricesParams.java

@@ -42,7 +42,11 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.differentialPrice.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "differential_price[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[")
+                ? "differential_price[" + key.replace("[", "][")
+                : "differential_price[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }

src/main/java/com/chargebee/v4/models/export/params/ExportInvoicesParams.java

@@ -45,7 +45,9 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.invoice.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "invoice[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[") ? "invoice[" + key.replace("[", "][") : "invoice[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }

src/main/java/com/chargebee/v4/models/export/params/ExportItemFamiliesParams.java

@@ -44,7 +44,11 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.itemFamily.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "item_family[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[")
+                ? "item_family[" + key.replace("[", "][")
+                : "item_family[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }

src/main/java/com/chargebee/v4/models/export/params/ExportItemPricesParams.java

@@ -45,7 +45,9 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.itemPrice.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "item_price[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[") ? "item_price[" + key.replace("[", "][") : "item_price[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }

src/main/java/com/chargebee/v4/models/export/params/ExportItemsParams.java

@@ -44,7 +44,9 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.item.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "item[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[") ? "item[" + key.replace("[", "][") : "item[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }

src/main/java/com/chargebee/v4/models/export/params/ExportOrdersParams.java

@@ -45,7 +45,9 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.order.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "order[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[") ? "order[" + key.replace("[", "][") : "order[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }

src/main/java/com/chargebee/v4/models/export/params/ExportPlansParams.java

@@ -45,7 +45,9 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.plan.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "plan[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[") ? "plan[" + key.replace("[", "][") : "plan[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }

src/main/java/com/chargebee/v4/models/export/params/ExportPriceVariantsParams.java

@@ -44,7 +44,11 @@ public Map<String, Object> toFormData() {
       // Single object
       Map<String, Object> nestedData = this.priceVariant.toFormData();
       for (Map.Entry<String, Object> entry : nestedData.entrySet()) {
-        String nestedKey = "price_variant[" + entry.getKey() + "]";
+        String key = entry.getKey();
+        String nestedKey =
+            key.contains("[")
+                ? "price_variant[" + key.replace("[", "][")
+                : "price_variant[" + key + "]";
         formData.put(nestedKey, entry.getValue());
       }
     }