Webhook handler

build.gradle.kts

@@ -6,7 +6,7 @@ plugins {
 }
 
 group = "com.chargebee"
-version = "4.0.0-beta.2"
+version = "4.0.0"
 description = "Next-gen Java client library for ChargeBee API"
 
 // Project metadata

docs/MIGRATION_GUIDE.md

@@ -34,7 +34,7 @@ The v4 SDK provides a modern, immutable client with enhanced type safety and imp
 <dependency>
   <groupId>com.chargebee</groupId>
   <artifactId>chargebee-java</artifactId>
-  <version>4.0.0-beta.1</version>
+  <version>4.0.0</version>
 </dependency>
 ```
 

src/main/java/com/chargebee/v4/client/ChargebeeClient.java

@@ -3,6 +3,11 @@
 import com.chargebee.v4.client.request.RequestContext;
 import com.chargebee.v4.client.request.RequestInterceptor;
 import com.chargebee.v4.client.request.RequestWrap;
+import com.chargebee.v4.exceptions.ChargebeeException;
+import com.chargebee.v4.exceptions.ConfigurationException;
+import com.chargebee.v4.exceptions.NetworkException;
+import com.chargebee.v4.exceptions.TimeoutException;
+import com.chargebee.v4.exceptions.TransportException;
 import com.chargebee.v4.internal.RetryConfig;
 import com.chargebee.v4.transport.*;
 import com.chargebee.v4.transport.Transport;
@@ -105,9 +110,9 @@ public String getBaseUrl() {
      * @param path the API path (e.g., "/customers")
      * @param queryParams optional query parameters
      * @return the HTTP response
-     * @throws Exception for network, timeout, configuration failures, or interceptor errors
+     * @throws ChargebeeException for network, timeout, configuration failures, or interceptor errors
      */
-    public Response get(String path, Map<String, List<String>> queryParams) throws Exception {
+    public Response get(String path, Map<String, List<String>> queryParams) throws ChargebeeException {
         Map<String, Object> objectParams = new HashMap<>(queryParams);
         String fullUrl = UrlBuilder.buildUrl(getBaseUrl(), path, objectParams);
         Request.Builder builder = Request.builder()
@@ -126,9 +131,9 @@ public Response get(String path, Map<String, List<String>> queryParams) throws E
      * 
      * @param path the API path (e.g., "/customers")
      * @return the HTTP response
-     * @throws Exception for network, timeout, configuration failures, or interceptor errors
+     * @throws ChargebeeException for network, timeout, configuration failures, or interceptor errors
      */
-    public Response get(String path) throws Exception {
+    public Response get(String path) throws ChargebeeException {
         return get(path, Collections.emptyMap());
     }
 
@@ -169,9 +174,9 @@ public CompletableFuture<Response> getAsync(String path) {
      * @param path the API path (e.g., "/customers")
      * @param formData the form data to send
      * @return the HTTP response
-     * @throws Exception for network, timeout, configuration failures, or interceptor errors
+     * @throws ChargebeeException for network, timeout, configuration failures, or interceptor errors
      */
-    public Response post(String path, Map<String, Object> formData) throws Exception {
+    public Response post(String path, Map<String, Object> formData) throws ChargebeeException {
         String fullUrl = UrlBuilder.buildUrl(getBaseUrl(), path, null);
         Request.Builder builder = Request.builder()
                 .method("POST")
@@ -191,9 +196,9 @@ public Response post(String path, Map<String, Object> formData) throws Exception
      * @param path the API path (e.g., "/customers")
      * @param jsonData the JSON data to send
      * @return the HTTP response
-     * @throws Exception for network, timeout, configuration failures, or interceptor errors
+     * @throws ChargebeeException for network, timeout, configuration failures, or interceptor errors
      */
-    public Response postJson(String path, String jsonData) throws Exception {
+    public Response postJson(String path, String jsonData) throws ChargebeeException {
         String fullUrl = UrlBuilder.buildUrl(getBaseUrl(), path, null);
         Request.Builder builder = Request.builder()
                 .method("POST")
@@ -252,7 +257,7 @@ public CompletableFuture<Response> postJsonAsync(String path, String jsonData) {
     /**
      * Execute a request with optional interceptor.
      */
-    public Response executeWithInterceptor(Request request) throws Exception {
+    public Response executeWithInterceptor(Request request) throws ChargebeeException {
         if (requestInterceptor != null) {
             RequestWrap requestWrap = new RequestWrap(this, request);
             return requestInterceptor.handleRequest(requestWrap);
@@ -276,7 +281,7 @@ public CompletableFuture<Response> executeWithInterceptorAsync(Request request)
     /**
      * Send a request with retry logic based on the configured RetryConfig.
      */
-    public Response sendWithRetry(Request request) throws TransportException {
+    public Response sendWithRetry(Request request) {
         Request enrichedRequest = addDefaultHeaders(request);
 
         Integer overrideRetries = enrichedRequest.getMaxNetworkRetriesOverride();