add subdomain support and JSON payload support (#87)

cb-karthikp · web-flow · commit 1aec9ed405f9 · 2026-02-18T12:47:19.000+05:30
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,10 @@
+### v4.2.0 (2026-02-16)
+* * *
+
+### New Features:
+* Added subdomain routing support for API requests.
+* Added JSON request body support for applicable APIs.
+
 ### v4.1.1 (2026-02-10)
 * * *
 ### Bug Fixes:
diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-4.1.1
+4.2.0
diff --git a/build.gradle.kts b/build.gradle.kts
@@ -7,7 +7,7 @@ plugins {
 }
 
 group = "com.chargebee"
-version = "4.1.1"
+version = "4.2.0"
 description = "Java client library for ChargeBee"
 
 // Project metadata
diff --git a/src/main/java/com/chargebee/v4/client/ChargebeeClient.java b/src/main/java/com/chargebee/v4/client/ChargebeeClient.java
@@ -103,7 +103,7 @@ public String getBaseUrl() {
         }
         return String.format("%s://%s.%s/api/v2", protocol, siteName, domainSuffix);
     }
-    
+
     /**
      * Send a GET request to the specified path.
      * 
diff --git a/src/main/java/com/chargebee/v4/internal/SubDomain.java b/src/main/java/com/chargebee/v4/internal/SubDomain.java
@@ -0,0 +1,30 @@
+/*
+ * This file is auto-generated by Chargebee.
+ * Copyright 2026 Chargebee Inc.
+ */
+
+package com.chargebee.v4.internal;
+
+/** Subdomain identifiers for routing API operations to the correct service endpoint. */
+public enum SubDomain {
+  INGEST("ingest"),
+
+  FILE_INGEST("file-ingest"),
+
+  GROW("grow");
+
+  private final String value;
+
+  SubDomain(String value) {
+    this.value = value;
+  }
+
+  /**
+   * Get the string value of this subdomain.
+   *
+   * @return the subdomain string value
+   */
+  public String getValue() {
+    return value;
+  }
+}
diff --git a/src/main/java/com/chargebee/v4/models/offerEvent/params/OfferEventsParams.java b/src/main/java/com/chargebee/v4/models/offerEvent/params/OfferEventsParams.java
@@ -7,6 +7,7 @@
 package com.chargebee.v4.models.offerEvent.params;
 
 import com.chargebee.v4.internal.Recommended;
+import com.chargebee.v4.internal.JsonUtil;
 
 import java.util.LinkedHashMap;
 import java.util.Map;
@@ -49,6 +50,11 @@ public Map<String, Object> toFormData() {
     return formData;
   }
 
+  /** Get the JSON string representation for this request. */
+  public String toJsonString() {
+    return JsonUtil.toJson(toFormData());
+  }
+
   /** Create a new builder for OfferEventsParams. */
   @Recommended(reason = "Preferred for reusability, validation, and LLM-friendliness")
   public static OfferEventsBuilder builder() {
diff --git a/src/main/java/com/chargebee/v4/models/offerFulfillment/params/OfferFulfillmentsParams.java b/src/main/java/com/chargebee/v4/models/offerFulfillment/params/OfferFulfillmentsParams.java
@@ -7,6 +7,7 @@
 package com.chargebee.v4.models.offerFulfillment.params;
 
 import com.chargebee.v4.internal.Recommended;
+import com.chargebee.v4.internal.JsonUtil;
 
 import java.util.LinkedHashMap;
 import java.util.Map;
@@ -49,6 +50,11 @@ public Map<String, Object> toFormData() {
     return formData;
   }
 
+  /** Get the JSON string representation for this request. */
+  public String toJsonString() {
+    return JsonUtil.toJson(toFormData());
+  }
+
   /** Create a new builder for OfferFulfillmentsParams. */
   @Recommended(reason = "Preferred for reusability, validation, and LLM-friendliness")
   public static OfferFulfillmentsBuilder builder() {
diff --git a/src/main/java/com/chargebee/v4/models/offerFulfillment/params/OfferFulfillmentsUpdateParams.java b/src/main/java/com/chargebee/v4/models/offerFulfillment/params/OfferFulfillmentsUpdateParams.java
@@ -7,6 +7,7 @@
 package com.chargebee.v4.models.offerFulfillment.params;
 
 import com.chargebee.v4.internal.Recommended;
+import com.chargebee.v4.internal.JsonUtil;
 
 import java.util.LinkedHashMap;
 import java.util.Map;
@@ -62,6 +63,11 @@ public Map<String, Object> toFormData() {
     return formData;
   }
 
+  /** Get the JSON string representation for this request. */
+  public String toJsonString() {
+    return JsonUtil.toJson(toFormData());
+  }
+
   /** Create a new builder for OfferFulfillmentsUpdateParams. */
   @Recommended(reason = "Preferred for reusability, validation, and LLM-friendliness")
   public static OfferFulfillmentsUpdateBuilder builder() {
diff --git a/src/main/java/com/chargebee/v4/models/personalizedOffer/params/PersonalizedOffersParams.java b/src/main/java/com/chargebee/v4/models/personalizedOffer/params/PersonalizedOffersParams.java
@@ -147,6 +147,11 @@ public Map<String, Object> toFormData() {
     return formData;
   }
 
+  /** Get the JSON string representation for this request. */
+  public String toJsonString() {
+    return JsonUtil.toJson(toFormData());
+  }
+
   /** Create a new builder for PersonalizedOffersParams. */
   @Recommended(reason = "Preferred for reusability, validation, and LLM-friendliness")
   public static PersonalizedOffersBuilder builder() {
@@ -302,6 +307,11 @@ public Map<String, Object> toFormData() {
       return formData;
     }
 
+    /** Get the JSON string representation for this request. */
+    public String toJsonString() {
+      return JsonUtil.toJson(toFormData());
+    }
+
     /** Create a new builder for RequestContextParams. */
     @Recommended(reason = "Preferred for reusability, validation, and LLM-friendliness")
     public static RequestContextBuilder builder() {
diff --git a/src/main/java/com/chargebee/v4/models/usageEvent/params/UsageEventBatchIngestParams.java b/src/main/java/com/chargebee/v4/models/usageEvent/params/UsageEventBatchIngestParams.java
@@ -49,6 +49,11 @@ public Map<String, Object> toFormData() {
     return formData;
   }
 
+  /** Get the JSON string representation for this request. */
+  public String toJsonString() {
+    return JsonUtil.toJson(toFormData());
+  }
+
   /** Create a new builder for UsageEventBatchIngestParams. */
   @Recommended(reason = "Preferred for reusability, validation, and LLM-friendliness")
   public static UsageEventBatchIngestBuilder builder() {
@@ -135,6 +140,11 @@ public Map<String, Object> toFormData() {
       return formData;
     }
 
+    /** Get the JSON string representation for this request. */
+    public String toJsonString() {
+      return JsonUtil.toJson(toFormData());
+    }
+
     /** Create a new builder for EventsParams. */
     @Recommended(reason = "Preferred for reusability, validation, and LLM-friendliness")
     public static EventsBuilder builder() {
diff --git a/src/main/java/com/chargebee/v4/models/usageEvent/params/UsageEventCreateParams.java b/src/main/java/com/chargebee/v4/models/usageEvent/params/UsageEventCreateParams.java
@@ -76,6 +76,11 @@ public Map<String, Object> toFormData() {
     return formData;
   }
 
+  /** Get the JSON string representation for this request. */
+  public String toJsonString() {
+    return JsonUtil.toJson(toFormData());
+  }
+
   /** Create a new builder for UsageEventCreateParams. */
   @Recommended(reason = "Preferred for reusability, validation, and LLM-friendliness")
   public static UsageEventCreateBuilder builder() {
diff --git a/src/main/java/com/chargebee/v4/services/BaseService.java b/src/main/java/com/chargebee/v4/services/BaseService.java
@@ -108,6 +108,19 @@ protected Response post(String path, Map<String, Object> formData) throws Charge
         return client.executeWithInterceptor(builder.build());
     }
 
+    /**
+     * Helper: POST with subdomain routing.
+     */
+    protected Response postWithSubDomain(String path, String subDomain, Map<String, Object> formData) throws ChargebeeException {
+        String fullUrl = UrlBuilder.buildUrl(baseUrlWithSubDomain(subDomain), path, null);
+        Request.Builder builder = Request.builder()
+                .method("POST")
+                .url(fullUrl)
+                .formBody(formData);
+        applyMergedHeaders(builder);
+        return client.executeWithInterceptor(builder.build());
+    }
+
     /**
      * Helper: POST JSON with optional headers.
      */
@@ -121,6 +134,19 @@ protected Response postJson(String path, String jsonData) throws ChargebeeExcept
         return client.executeWithInterceptor(builder.build());
     }
 
+    /**
+     * Helper: POST JSON with subdomain routing.
+     */
+    protected Response postJsonWithSubDomain(String path, String subDomain, String jsonData) throws ChargebeeException {
+        String fullUrl = UrlBuilder.buildUrl(baseUrlWithSubDomain(subDomain), path, null);
+        Request.Builder builder = Request.builder()
+                .method("POST")
+                .url(fullUrl)
+                .jsonBody(jsonData);
+        applyMergedHeaders(builder);
+        return client.executeWithInterceptor(builder.build());
+    }
+
     /**
      * Helper: POST async with optional headers.
      */
@@ -183,6 +209,31 @@ protected Response get(String path, Map<String, Object> queryParams) throws Char
         return client.executeWithInterceptor(builder.build());
     }
     
+    /**
+     * GET with subdomain routing.
+     */
+    protected Response getWithSubDomain(String path, String subDomain, Map<String, Object> queryParams) throws ChargebeeException {
+        String fullUrl = UrlBuilder.buildUrl(baseUrlWithSubDomain(subDomain), path, queryParams);
+        Request.Builder builder = Request.builder()
+                .method("GET")
+                .url(fullUrl);
+        applyMergedHeaders(builder);
+        return client.executeWithInterceptor(builder.build());
+    }
+
+    /**
+     * Build base URL with subdomain prefix for routing.
+     * Constructs {@code protocol://siteName.subDomain.domainSuffix/api/v2}.
+     */
+    private String baseUrlWithSubDomain(String subDomain) {
+        String endpoint = client.getEndpoint();
+        if (endpoint != null && !endpoint.trim().isEmpty()) {
+            return endpoint;
+        }
+        return String.format("%s://%s.%s.%s/api/v2",
+                client.getProtocol(), client.getSiteName(), subDomain, client.getDomainSuffix());
+    }
+
     /**
      * GET async with Object query parameters.
      */
diff --git a/src/main/java/com/chargebee/v4/services/OfferEventService.java b/src/main/java/com/chargebee/v4/services/OfferEventService.java
@@ -16,6 +16,8 @@
 
 import com.chargebee.v4.models.offerEvent.responses.OfferEventsResponse;
 
+import com.chargebee.v4.internal.SubDomain;
+
 public final class OfferEventService extends BaseService<OfferEventService> {
 
   private final ServiceConfig config;
@@ -55,15 +57,16 @@ public OfferEventService withOptions(RequestOptions options) {
    */
   Response offerEventsRaw(OfferEventsParams params) throws ChargebeeException {
 
-    return post("/offer_events", params != null ? params.toFormData() : null);
+    return postJsonWithSubDomain(
+        "/offer_events", SubDomain.GROW.getValue(), params != null ? params.toJsonString() : null);
   }
 
   /**
    * offerEvents a offerEvent using raw JSON payload (executes immediately) - returns raw Response.
    */
   Response offerEventsRaw(String jsonPayload) throws ChargebeeException {
 
-    return postJson("/offer_events", jsonPayload);
+    return postJsonWithSubDomain("/offer_events", SubDomain.GROW.getValue(), jsonPayload);
   }
 
   public OfferEventsResponse offerEvents(OfferEventsParams params) throws ChargebeeException {
diff --git a/src/main/java/com/chargebee/v4/services/OfferFulfillmentService.java b/src/main/java/com/chargebee/v4/services/OfferFulfillmentService.java
@@ -22,6 +22,8 @@
 
 import com.chargebee.v4.models.offerFulfillment.responses.OfferFulfillmentsUpdateResponse;
 
+import com.chargebee.v4.internal.SubDomain;
+
 public final class OfferFulfillmentService extends BaseService<OfferFulfillmentService> {
 
   private final ServiceConfig config;
@@ -63,7 +65,10 @@ public OfferFulfillmentService withOptions(RequestOptions options) {
    */
   Response offerFulfillmentsRaw(OfferFulfillmentsParams params) throws ChargebeeException {
 
-    return post("/offer_fulfillments", params != null ? params.toFormData() : null);
+    return postJsonWithSubDomain(
+        "/offer_fulfillments",
+        SubDomain.GROW.getValue(),
+        params != null ? params.toJsonString() : null);
   }
 
   /**
@@ -72,7 +77,7 @@ Response offerFulfillmentsRaw(OfferFulfillmentsParams params) throws ChargebeeEx
    */
   Response offerFulfillmentsRaw(String jsonPayload) throws ChargebeeException {
 
-    return postJson("/offer_fulfillments", jsonPayload);
+    return postJsonWithSubDomain("/offer_fulfillments", SubDomain.GROW.getValue(), jsonPayload);
   }
 
   public OfferFulfillmentsResponse offerFulfillments(OfferFulfillmentsParams params)
@@ -90,7 +95,7 @@ Response offerFulfillmentsGetRaw(String offerFulfillmentId) throws ChargebeeExce
             "offer-fulfillment-id",
             offerFulfillmentId);
 
-    return get(path, null);
+    return getWithSubDomain(path, SubDomain.GROW.getValue(), null);
   }
 
   public OfferFulfillmentsGetResponse offerFulfillmentsGet(String offerFulfillmentId)
@@ -107,7 +112,7 @@ Response offerFulfillmentsUpdateRaw(String offerFulfillmentId) throws ChargebeeE
             "offer-fulfillment-id",
             offerFulfillmentId);
 
-    return post(path, null);
+    return postWithSubDomain(path, SubDomain.GROW.getValue(), null);
   }
 
   /**
@@ -121,7 +126,8 @@ Response offerFulfillmentsUpdateRaw(
             "/offer_fulfillments/{offer-fulfillment-id}",
             "offer-fulfillment-id",
             offerFulfillmentId);
-    return post(path, params.toFormData());
+    return postJsonWithSubDomain(
+        path, SubDomain.GROW.getValue(), params != null ? params.toJsonString() : null);
   }
 
   /**
@@ -135,7 +141,7 @@ Response offerFulfillmentsUpdateRaw(String offerFulfillmentId, String jsonPayloa
             "/offer_fulfillments/{offer-fulfillment-id}",
             "offer-fulfillment-id",
             offerFulfillmentId);
-    return postJson(path, jsonPayload);
+    return postJsonWithSubDomain(path, SubDomain.GROW.getValue(), jsonPayload);
   }
 
   public OfferFulfillmentsUpdateResponse offerFulfillmentsUpdate(
diff --git a/src/main/java/com/chargebee/v4/services/PersonalizedOfferService.java b/src/main/java/com/chargebee/v4/services/PersonalizedOfferService.java
@@ -16,6 +16,8 @@
 
 import com.chargebee.v4.models.personalizedOffer.responses.PersonalizedOffersResponse;
 
+import com.chargebee.v4.internal.SubDomain;
+
 public final class PersonalizedOfferService extends BaseService<PersonalizedOfferService> {
 
   private final ServiceConfig config;
@@ -57,7 +59,10 @@ public PersonalizedOfferService withOptions(RequestOptions options) {
    */
   Response personalizedOffersRaw(PersonalizedOffersParams params) throws ChargebeeException {
 
-    return post("/personalized_offers", params != null ? params.toFormData() : null);
+    return postJsonWithSubDomain(
+        "/personalized_offers",
+        SubDomain.GROW.getValue(),
+        params != null ? params.toJsonString() : null);
   }
 
   /**
@@ -66,7 +71,7 @@ Response personalizedOffersRaw(PersonalizedOffersParams params) throws Chargebee
    */
   Response personalizedOffersRaw(String jsonPayload) throws ChargebeeException {
 
-    return postJson("/personalized_offers", jsonPayload);
+    return postJsonWithSubDomain("/personalized_offers", SubDomain.GROW.getValue(), jsonPayload);
   }
 
   public PersonalizedOffersResponse personalizedOffers(PersonalizedOffersParams params)
diff --git a/src/main/java/com/chargebee/v4/services/UsageEventService.java b/src/main/java/com/chargebee/v4/services/UsageEventService.java
diff --git a/src/main/java/com/chargebee/v4/services/UsageFileService.java b/src/main/java/com/chargebee/v4/services/UsageFileService.java
diff --git a/src/test/java/com/chargebee/v4/client/SubDomainSupportTest.java b/src/test/java/com/chargebee/v4/client/SubDomainSupportTest.java
diff --git a/src/test/java/com/chargebee/v4/services/TestSubDomainService.java b/src/test/java/com/chargebee/v4/services/TestSubDomainService.java

Original file line number	Diff line number	Diff line change
`@@ -7,7 +7,7 @@ plugins {`
`7`	`7`	`}`
`8`	`8`
`9`	`9`	`group = "com.chargebee"`
`10`		`-version = "4.1.1"`
	`10`	`+version = "4.2.0"`
`11`	`11`	`description = "Java client library for ChargeBee"`
`12`	`12`
`13`	`13`	`// Project metadata`
Original file line number	Diff line number	Diff line change
`@@ -103,7 +103,7 @@ public String getBaseUrl() {`
`103`	`103`	`}`
`104`	`104`	`return String.format("%s://%s.%s/api/v2", protocol, siteName, domainSuffix);`
`105`	`105`	`}`
`106`		`-`
	`106`	`+`
`107`	`107`	`/**`
`108`	`108`	`* Send a GET request to the specified path.`
`109`	`109`	`*`