docs(api): improve SettlementDetail event_tokens and transaction_token descriptions

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

src/resources/reports/reports.ts

@@ -143,7 +143,8 @@ export interface SettlementDetail {
   disputes_gross_amount: number;
 
   /**
-   * 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.
    */
   event_tokens: Array<string>;
 
@@ -191,7 +192,12 @@ export interface SettlementDetail {
   settlement_date: string;
 
   /**
-   * 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.
    */
   transaction_token: string;