docs(api): improve event_tokens and transaction_token field docs in SettlementDetail

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 191
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-0572da655d188e23459f2115b03b27040b4c4d3b47e4a86510803892d0d1b0aa.yml
-openapi_spec_hash: b615a0eb16502b4de874f9ae28491894
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic/lithic-a46ebb10f6bb217a591206f0574450c324f108dbd32a2d62727cd8186d85e94f.yml
+openapi_spec_hash: f320c173152f74b0799166b6ef5b82cd
 config_hash: ac8326134e692f3f3bdec82396bbec80

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

@@ -186,7 +186,8 @@ private constructor(
     fun disputesGrossAmount(): Long = disputesGrossAmount.getRequired("disputes_gross_amount")
 
     /**
-     * Globally unique identifiers denoting the Events associated with this settlement.
+     * Array of globally unique identifiers for the financial events that comprise this settlement.
+     * Use these tokens to access detailed event-level information.
      *
      * @throws LithicInvalidDataException if the JSON field has an unexpected type or is
      *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -262,7 +263,11 @@ private constructor(
     fun settlementDate(): String = settlementDate.getRequired("settlement_date")
 
     /**
-     * Globally unique identifier denoting the associated Transaction object.
+     * Globally unique identifier denoting the associated transaction. For settlement records with
+     * type `CLEARING`, `FINANCIAL`, or `NON-FINANCIAL`, this references a card transaction token.
+     * For settlement records with type `CHARGEBACK`, `REPRESENTMENT`, `PREARBITRATION`,
+     * `ARBITRATION`, or `COLLABORATION`, this references the dispute transaction token. May be null
+     * for certain settlement types.
      *
      * @throws LithicInvalidDataException if the JSON field has an unexpected type or is
      *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -676,7 +681,10 @@ private constructor(
             this.disputesGrossAmount = disputesGrossAmount
         }
 
-        /** Globally unique identifiers denoting the Events associated with this settlement. */
+        /**
+         * Array of globally unique identifiers for the financial events that comprise this
+         * settlement. Use these tokens to access detailed event-level information.
+         */
         fun eventTokens(eventTokens: List<String>) = eventTokens(JsonField.of(eventTokens))
 
         /**
@@ -818,7 +826,13 @@ private constructor(
             this.settlementDate = settlementDate
         }
 
-        /** Globally unique identifier denoting the associated Transaction object. */
+        /**
+         * Globally unique identifier denoting the associated transaction. For settlement records
+         * with type `CLEARING`, `FINANCIAL`, or `NON-FINANCIAL`, this references a card transaction
+         * token. For settlement records with type `CHARGEBACK`, `REPRESENTMENT`, `PREARBITRATION`,
+         * `ARBITRATION`, or `COLLABORATION`, this references the dispute transaction token. May be
+         * null for certain settlement types.
+         */
         fun transactionToken(transactionToken: String) =
             transactionToken(JsonField.of(transactionToken))