feat(api): changes to balance-related return types and other API chan…

…ges (#210)

lithic-java-core/src/main/kotlin/com/lithic/api/models/Account.kt

@@ -54,8 +54,11 @@ private constructor(
      * Account state:
      * - `ACTIVE` - Account is able to transact and create new cards.
      * - `PAUSED` - Account will not be able to transact or create new cards. It can be set back to
-     *   `ACTIVE`. `CLOSED` - Account will not be able to transact or create new cards. `CLOSED`
-     *   cards are also unable to be transitioned to `ACTIVE` or `PAUSED` states.
+     *   `ACTIVE`.
+     * - `CLOSED` - Account will not be able to transact or create new cards. `CLOSED` accounts are
+     *   also unable to be transitioned to `ACTIVE` or `PAUSED` states. `CLOSED` accounts result
+     *   from failing to pass KYB/KYC or Lithic closing for risk/compliance reasons. Please contact
+     *   [[email protected]](mailto:[email protected]) if you believe this was in error.
      */
     fun state(): State = state.getRequired("state")
 
@@ -85,8 +88,11 @@ private constructor(
      * Account state:
      * - `ACTIVE` - Account is able to transact and create new cards.
      * - `PAUSED` - Account will not be able to transact or create new cards. It can be set back to
-     *   `ACTIVE`. `CLOSED` - Account will not be able to transact or create new cards. `CLOSED`
-     *   cards are also unable to be transitioned to `ACTIVE` or `PAUSED` states.
+     *   `ACTIVE`.
+     * - `CLOSED` - Account will not be able to transact or create new cards. `CLOSED` accounts are
+     *   also unable to be transitioned to `ACTIVE` or `PAUSED` states. `CLOSED` accounts result
+     *   from failing to pass KYB/KYC or Lithic closing for risk/compliance reasons. Please contact
+     *   [[email protected]](mailto:[email protected]) if you believe this was in error.
      */
     @JsonProperty("state") @ExcludeMissing fun _state() = state
 
@@ -219,17 +225,25 @@ private constructor(
          * Account state:
          * - `ACTIVE` - Account is able to transact and create new cards.
          * - `PAUSED` - Account will not be able to transact or create new cards. It can be set back
-         *   to `ACTIVE`. `CLOSED` - Account will not be able to transact or create new cards.
-         *   `CLOSED` cards are also unable to be transitioned to `ACTIVE` or `PAUSED` states.
+         *   to `ACTIVE`.
+         * - `CLOSED` - Account will not be able to transact or create new cards. `CLOSED` accounts
+         *   are also unable to be transitioned to `ACTIVE` or `PAUSED` states. `CLOSED` accounts
+         *   result from failing to pass KYB/KYC or Lithic closing for risk/compliance reasons.
+         *   Please contact [[email protected]](mailto:[email protected]) if you believe this was
+         *   in error.
          */
         fun state(state: State) = state(JsonField.of(state))
 
         /**
          * Account state:
          * - `ACTIVE` - Account is able to transact and create new cards.
          * - `PAUSED` - Account will not be able to transact or create new cards. It can be set back
-         *   to `ACTIVE`. `CLOSED` - Account will not be able to transact or create new cards.
-         *   `CLOSED` cards are also unable to be transitioned to `ACTIVE` or `PAUSED` states.
+         *   to `ACTIVE`.
+         * - `CLOSED` - Account will not be able to transact or create new cards. `CLOSED` accounts
+         *   are also unable to be transitioned to `ACTIVE` or `PAUSED` states. `CLOSED` accounts
+         *   result from failing to pass KYB/KYC or Lithic closing for risk/compliance reasons.
+         *   Please contact [[email protected]](mailto:[email protected]) if you believe this was
+         *   in error.
          */
         @JsonProperty("state")
         @ExcludeMissing

lithic-java-core/src/main/kotlin/com/lithic/api/models/Balance.kt

@@ -18,7 +18,7 @@ import com.lithic.api.errors.LithicInvalidDataException
 import java.time.OffsetDateTime
 import java.util.Objects
 
-/** Balance of a Financial Account */
+/** Balance */
 @JsonDeserialize(builder = Balance.Builder::class)
 @NoAutoDetect
 class Balance