docs(types): improve settlement_detail field descriptions

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 190
-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

src/lithic/types/settlement_detail.py

@@ -50,7 +50,8 @@ class SettlementDetail(BaseModel):
 
     event_tokens: List[str]
     """
-    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.
     """
 
     institution: str
@@ -85,7 +86,14 @@ class SettlementDetail(BaseModel):
     """
 
     transaction_token: str
-    """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.
+    """
 
     transactions_gross_amount: int
     """