release: 0.390.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.389.0"
+  ".": "0.390.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 227
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-63db8a5872b6a112abfc879f75a53bc6975994025752e86b27ab327884d94655.yml
-openapi_spec_hash: b7ffb71e0102fcd040a575bf917656e3
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/increase%2Fincrease-4e978c9426fb846c81f3169f5c1bc7aad137577c13e52ac48fcc756e613a1557.yml
+openapi_spec_hash: b44f228e3feac325305cd744c072ebc9
 config_hash: ca52ca9a2968f330339fd50c1a386e05

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.390.0 (2026-01-05)
+
+Full Changelog: [v0.389.0...v0.390.0](https://github.com/Increase/increase-java/compare/v0.389.0...v0.390.0)
+
+### Features
+
+* **api:** api update ([03ee177](https://github.com/Increase/increase-java/commit/03ee177555c58bfe68a197658753b7ea9ebe282e))
+* **client:** add `HttpRequest#url()` method ([ab5d43a](https://github.com/Increase/increase-java/commit/ab5d43a329eac1ef864127751bb109097abb6742))
+
 ## 0.389.0 (2026-01-01)
 
 Full Changelog: [v0.388.0...v0.389.0](https://github.com/Increase/increase-java/compare/v0.388.0...v0.389.0)

README.md

@@ -2,8 +2,8 @@
 
 <!-- x-release-please-start-version -->
 
-[![Maven Central](https://img.shields.io/maven-central/v/com.increase.api/increase-java)](https://central.sonatype.com/artifact/com.increase.api/increase-java/0.389.0)
-[![javadoc](https://javadoc.io/badge2/com.increase.api/increase-java/0.389.0/javadoc.svg)](https://javadoc.io/doc/com.increase.api/increase-java/0.389.0)
+[![Maven Central](https://img.shields.io/maven-central/v/com.increase.api/increase-java)](https://central.sonatype.com/artifact/com.increase.api/increase-java/0.390.0)
+[![javadoc](https://javadoc.io/badge2/com.increase.api/increase-java/0.390.0/javadoc.svg)](https://javadoc.io/doc/com.increase.api/increase-java/0.390.0)
 
 <!-- x-release-please-end -->
 
@@ -13,7 +13,7 @@ The Increase Java SDK is similar to the Increase Kotlin SDK but with minor diffe
 
 <!-- x-release-please-start-version -->
 
-The REST API documentation can be found on [increase.com](https://increase.com/documentation). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.increase.api/increase-java/0.389.0).
+The REST API documentation can be found on [increase.com](https://increase.com/documentation). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.increase.api/increase-java/0.390.0).
 
 <!-- x-release-please-end -->
 
@@ -24,7 +24,7 @@ The REST API documentation can be found on [increase.com](https://increase.com/d
 ### Gradle
 
 ```kotlin
-implementation("com.increase.api:increase-java:0.389.0")
+implementation("com.increase.api:increase-java:0.390.0")
 ```
 
 ### Maven
@@ -33,7 +33,7 @@ implementation("com.increase.api:increase-java:0.389.0")
 <dependency>
   <groupId>com.increase.api</groupId>
   <artifactId>increase-java</artifactId>
-  <version>0.389.0</version>
+  <version>0.390.0</version>
 </dependency>
 ```
 

build.gradle.kts

@@ -8,7 +8,7 @@ repositories {
 
 allprojects {
     group = "com.increase.api"
-    version = "0.389.0" // x-release-please-version
+    version = "0.390.0" // x-release-please-version
 }
 
 subprojects {

increase-java-core/src/main/kotlin/com/increase/api/core/http/HttpRequest.kt

@@ -2,6 +2,7 @@ package com.increase.api.core.http
 
 import com.increase.api.core.checkRequired
 import com.increase.api.core.toImmutable
+import java.net.URLEncoder
 
 class HttpRequest
 private constructor(
@@ -13,6 +14,35 @@ private constructor(
     @get:JvmName("body") val body: HttpRequestBody?,
 ) {
 
+    fun url(): String = buildString {
+        append(baseUrl)
+
+        pathSegments.forEach { segment ->
+            if (!endsWith("/")) {
+                append("/")
+            }
+            append(URLEncoder.encode(segment, "UTF-8"))
+        }
+
+        if (queryParams.isEmpty()) {
+            return@buildString
+        }
+
+        append("?")
+        var isFirst = true
+        queryParams.keys().forEach { key ->
+            queryParams.values(key).forEach { value ->
+                if (!isFirst) {
+                    append("&")
+                }
+                append(URLEncoder.encode(key, "UTF-8"))
+                append("=")
+                append(URLEncoder.encode(value, "UTF-8"))
+                isFirst = false
+            }
+        }
+    }
+
     fun toBuilder(): Builder = Builder().from(this)
 
     override fun toString(): String =

increase-java-core/src/main/kotlin/com/increase/api/models/carddisputes/CardDispute.kt

@@ -11416,6 +11416,7 @@ private constructor(
             private val category: JsonField<Category>,
             private val chargeback: JsonField<Chargeback>,
             private val createdAt: JsonField<OffsetDateTime>,
+            private val explanation: JsonField<String>,
             private val furtherInformationRequestedAt: JsonField<OffsetDateTime>,
             private val furtherInformationRequestedReason: JsonField<String>,
             private val merchantPrearbitrationDecline: JsonField<MerchantPrearbitrationDecline>,
@@ -11443,6 +11444,9 @@ private constructor(
                 @JsonProperty("created_at")
                 @ExcludeMissing
                 createdAt: JsonField<OffsetDateTime> = JsonMissing.of(),
+                @JsonProperty("explanation")
+                @ExcludeMissing
+                explanation: JsonField<String> = JsonMissing.of(),
                 @JsonProperty("further_information_requested_at")
                 @ExcludeMissing
                 furtherInformationRequestedAt: JsonField<OffsetDateTime> = JsonMissing.of(),
@@ -11469,6 +11473,7 @@ private constructor(
                 category,
                 chargeback,
                 createdAt,
+                explanation,
                 furtherInformationRequestedAt,
                 furtherInformationRequestedReason,
                 merchantPrearbitrationDecline,
@@ -11537,6 +11542,15 @@ private constructor(
              */
             fun createdAt(): OffsetDateTime = createdAt.getRequired("created_at")
 
+            /**
+             * The free-form explanation provided to Increase to provide more context for the user
+             * submission. This field is not sent directly to the card networks.
+             *
+             * @throws IncreaseInvalidDataException if the JSON field has an unexpected type (e.g.
+             *   if the server responded with an unexpected value).
+             */
+            fun explanation(): Optional<String> = explanation.getOptional("explanation")
+
             /**
              * The date and time at which Increase requested further information from the user for
              * the Visa Card Dispute.
@@ -11659,6 +11673,16 @@ private constructor(
             @ExcludeMissing
             fun _createdAt(): JsonField<OffsetDateTime> = createdAt
 
+            /**
+             * Returns the raw JSON value of [explanation].
+             *
+             * Unlike [explanation], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("explanation")
+            @ExcludeMissing
+            fun _explanation(): JsonField<String> = explanation
+
             /**
              * Returns the raw JSON value of [furtherInformationRequestedAt].
              *
@@ -11744,6 +11768,7 @@ private constructor(
                  * .category()
                  * .chargeback()
                  * .createdAt()
+                 * .explanation()
                  * .furtherInformationRequestedAt()
                  * .furtherInformationRequestedReason()
                  * .merchantPrearbitrationDecline()
@@ -11764,6 +11789,7 @@ private constructor(
                 private var category: JsonField<Category>? = null
                 private var chargeback: JsonField<Chargeback>? = null
                 private var createdAt: JsonField<OffsetDateTime>? = null
+                private var explanation: JsonField<String>? = null
                 private var furtherInformationRequestedAt: JsonField<OffsetDateTime>? = null
                 private var furtherInformationRequestedReason: JsonField<String>? = null
                 private var merchantPrearbitrationDecline:
@@ -11782,6 +11808,7 @@ private constructor(
                     category = userSubmission.category
                     chargeback = userSubmission.chargeback
                     createdAt = userSubmission.createdAt
+                    explanation = userSubmission.explanation
                     furtherInformationRequestedAt = userSubmission.furtherInformationRequestedAt
                     furtherInformationRequestedReason =
                         userSubmission.furtherInformationRequestedReason
@@ -11923,6 +11950,28 @@ private constructor(
                     this.createdAt = createdAt
                 }
 
+                /**
+                 * The free-form explanation provided to Increase to provide more context for the
+                 * user submission. This field is not sent directly to the card networks.
+                 */
+                fun explanation(explanation: String?) =
+                    explanation(JsonField.ofNullable(explanation))
+
+                /** Alias for calling [Builder.explanation] with `explanation.orElse(null)`. */
+                fun explanation(explanation: Optional<String>) =
+                    explanation(explanation.getOrNull())
+
+                /**
+                 * Sets [Builder.explanation] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.explanation] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun explanation(explanation: JsonField<String>) = apply {
+                    this.explanation = explanation
+                }
+
                 /**
                  * The date and time at which Increase requested further information from the user
                  * for the Visa Card Dispute.
@@ -12104,6 +12153,7 @@ private constructor(
                  * .category()
                  * .chargeback()
                  * .createdAt()
+                 * .explanation()
                  * .furtherInformationRequestedAt()
                  * .furtherInformationRequestedReason()
                  * .merchantPrearbitrationDecline()
@@ -12122,6 +12172,7 @@ private constructor(
                         checkRequired("category", category),
                         checkRequired("chargeback", chargeback),
                         checkRequired("createdAt", createdAt),
+                        checkRequired("explanation", explanation),
                         checkRequired(
                             "furtherInformationRequestedAt",
                             furtherInformationRequestedAt,
@@ -12154,6 +12205,7 @@ private constructor(
                 category().validate()
                 chargeback().ifPresent { it.validate() }
                 createdAt()
+                explanation()
                 furtherInformationRequestedAt()
                 furtherInformationRequestedReason()
                 merchantPrearbitrationDecline().ifPresent { it.validate() }
@@ -12185,6 +12237,7 @@ private constructor(
                     (category.asKnown().getOrNull()?.validity() ?: 0) +
                     (chargeback.asKnown().getOrNull()?.validity() ?: 0) +
                     (if (createdAt.asKnown().isPresent) 1 else 0) +
+                    (if (explanation.asKnown().isPresent) 1 else 0) +
                     (if (furtherInformationRequestedAt.asKnown().isPresent) 1 else 0) +
                     (if (furtherInformationRequestedReason.asKnown().isPresent) 1 else 0) +
                     (merchantPrearbitrationDecline.asKnown().getOrNull()?.validity() ?: 0) +
@@ -41052,6 +41105,7 @@ private constructor(
                     category == other.category &&
                     chargeback == other.chargeback &&
                     createdAt == other.createdAt &&
+                    explanation == other.explanation &&
                     furtherInformationRequestedAt == other.furtherInformationRequestedAt &&
                     furtherInformationRequestedReason == other.furtherInformationRequestedReason &&
                     merchantPrearbitrationDecline == other.merchantPrearbitrationDecline &&
@@ -41069,6 +41123,7 @@ private constructor(
                     category,
                     chargeback,
                     createdAt,
+                    explanation,
                     furtherInformationRequestedAt,
                     furtherInformationRequestedReason,
                     merchantPrearbitrationDecline,
@@ -41082,7 +41137,7 @@ private constructor(
             override fun hashCode(): Int = hashCode
 
             override fun toString() =
-                "UserSubmission{acceptedAt=$acceptedAt, amount=$amount, attachmentFiles=$attachmentFiles, category=$category, chargeback=$chargeback, createdAt=$createdAt, furtherInformationRequestedAt=$furtherInformationRequestedAt, furtherInformationRequestedReason=$furtherInformationRequestedReason, merchantPrearbitrationDecline=$merchantPrearbitrationDecline, status=$status, updatedAt=$updatedAt, userPrearbitration=$userPrearbitration, additionalProperties=$additionalProperties}"
+                "UserSubmission{acceptedAt=$acceptedAt, amount=$amount, attachmentFiles=$attachmentFiles, category=$category, chargeback=$chargeback, createdAt=$createdAt, explanation=$explanation, furtherInformationRequestedAt=$furtherInformationRequestedAt, furtherInformationRequestedReason=$furtherInformationRequestedReason, merchantPrearbitrationDecline=$merchantPrearbitrationDecline, status=$status, updatedAt=$updatedAt, userPrearbitration=$userPrearbitration, additionalProperties=$additionalProperties}"
         }
 
         override fun equals(other: Any?): Boolean {