straddle 0.1.1 → 0.2.0

data/rbi/straddle/models/payout_update_params.rbi

@@ -35,6 +35,12 @@ module Straddle
       sig { params(correlation_id: String).void }
       attr_writer :correlation_id
 
+      sig { returns(T.nilable(String)) }
+      attr_reader :idempotency_key
+
+      sig { params(idempotency_key: String).void }
+      attr_writer :idempotency_key
+
       sig { returns(T.nilable(String)) }
       attr_reader :request_id
 
@@ -54,6 +60,7 @@ module Straddle
           payment_date: Date,
           metadata: T.nilable(T::Hash[Symbol, String]),
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -71,6 +78,7 @@ module Straddle
         # information about the payout in a structured format.
         metadata: nil,
         correlation_id: nil,
+        idempotency_key: nil,
         request_id: nil,
         straddle_account_id: nil,
         request_options: {}
@@ -85,6 +93,7 @@ module Straddle
             payment_date: Date,
             metadata: T.nilable(T::Hash[Symbol, String]),
             correlation_id: String,
+            idempotency_key: String,
             request_id: String,
             straddle_account_id: String,
             request_options: Straddle::RequestOptions

data/rbi/straddle/models.rbi

@@ -75,6 +75,8 @@ module Straddle
 
   PaykeyRevealParams = Straddle::Models::PaykeyRevealParams
 
+  PaykeyReviewParams = Straddle::Models::PaykeyReviewParams
+
   PaykeySummaryPagedV1 = Straddle::Models::PaykeySummaryPagedV1
 
   PaykeyUnmaskedParams = Straddle::Models::PaykeyUnmaskedParams

data/rbi/straddle/resources/bridge/link.rbi

@@ -17,6 +17,7 @@ module Straddle
             config: Straddle::Bridge::LinkBankAccountParams::Config::OrHash,
             metadata: T.nilable(T::Hash[Symbol, String]),
             correlation_id: String,
+            idempotency_key: String,
             request_id: String,
             straddle_account_id: String,
             request_options: Straddle::RequestOptions::OrHash
@@ -39,6 +40,8 @@ module Straddle
           # Header param: Optional client generated identifier to trace and debug a series
           # of requests.
           correlation_id: nil,
+          # Header param: Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
           # Header param: Optional client generated identifier to trace and debug a request.
           request_id: nil,
           # Header param: For use by platforms to specify an account id and set scope of a
@@ -58,6 +61,7 @@ module Straddle
             config: Straddle::Bridge::LinkCreatePaykeyParams::Config::OrHash,
             metadata: T.nilable(T::Hash[Symbol, String]),
             correlation_id: String,
+            idempotency_key: String,
             request_id: String,
             straddle_account_id: String,
             request_options: Straddle::RequestOptions::OrHash
@@ -77,6 +81,8 @@ module Straddle
           # Header param: Optional client generated identifier to trace and debug a series
           # of requests.
           correlation_id: nil,
+          # Header param: Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
           # Header param: Optional client generated identifier to trace and debug a request.
           request_id: nil,
           # Header param: For use by platforms to specify an account id and set scope of a
@@ -96,6 +102,7 @@ module Straddle
             config: Straddle::Bridge::LinkCreateTanParams::Config::OrHash,
             metadata: T.nilable(T::Hash[Symbol, String]),
             correlation_id: String,
+            idempotency_key: String,
             request_id: String,
             straddle_account_id: String,
             request_options: Straddle::RequestOptions::OrHash
@@ -118,6 +125,8 @@ module Straddle
           # Header param: Optional client generated identifier to trace and debug a series
           # of requests.
           correlation_id: nil,
+          # Header param: Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
           # Header param: Optional client generated identifier to trace and debug a request.
           request_id: nil,
           # Header param: For use by platforms to specify an account id and set scope of a
@@ -137,6 +146,7 @@ module Straddle
             config: Straddle::Bridge::LinkPlaidParams::Config::OrHash,
             metadata: T.nilable(T::Hash[Symbol, String]),
             correlation_id: String,
+            idempotency_key: String,
             request_id: String,
             straddle_account_id: String,
             request_options: Straddle::RequestOptions::OrHash
@@ -156,6 +166,8 @@ module Straddle
           # Header param: Optional client generated identifier to trace and debug a series
           # of requests.
           correlation_id: nil,
+          # Header param: Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
           # Header param: Optional client generated identifier to trace and debug a request.
           request_id: nil,
           # Header param: For use by platforms to specify an account id and set scope of a

data/rbi/straddle/resources/bridge.rbi

@@ -12,6 +12,7 @@ module Straddle
           customer_id: String,
           config: Straddle::BridgeInitializeParams::Config::OrHash,
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -26,6 +27,8 @@ module Straddle
         # Header param: Optional client generated identifier to trace and debug a series
         # of requests.
         correlation_id: nil,
+        # Header param: Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Header param: Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # Header param: For use by platforms to specify an account id and set scope of a

data/rbi/straddle/resources/charges.rbi

@@ -17,6 +17,7 @@ module Straddle
           payment_date: Date,
           metadata: T.nilable(T::Hash[Symbol, String]),
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -52,6 +53,8 @@ module Straddle
         # Header param: Optional client generated identifier to trace and debug a series
         # of requests.
         correlation_id: nil,
+        # Header param: Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Header param: Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # Header param: For use by platforms to specify an account id and set scope of a
@@ -71,6 +74,7 @@ module Straddle
           payment_date: Date,
           metadata: T.nilable(T::Hash[Symbol, String]),
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -92,6 +96,8 @@ module Straddle
         # Header param: Optional client generated identifier to trace and debug a series
         # of requests.
         correlation_id: nil,
+        # Header param: Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Header param: Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # Header param: For use by platforms to specify an account id and set scope of a
@@ -108,6 +114,7 @@ module Straddle
           id: String,
           reason: T.nilable(String),
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -121,6 +128,8 @@ module Straddle
         # Header param: Optional client generated identifier to trace and debug a series
         # of requests.
         correlation_id: nil,
+        # Header param: Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Header param: Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # Header param: For use by platforms to specify an account id and set scope of a
@@ -160,6 +169,7 @@ module Straddle
           id: String,
           reason: T.nilable(String),
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -173,6 +183,8 @@ module Straddle
         # Header param: Optional client generated identifier to trace and debug a series
         # of requests.
         correlation_id: nil,
+        # Header param: Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Header param: Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # Header param: For use by platforms to specify an account id and set scope of a
@@ -189,6 +201,7 @@ module Straddle
           id: String,
           reason: T.nilable(String),
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -202,6 +215,8 @@ module Straddle
         # Header param: Optional client generated identifier to trace and debug a series
         # of requests.
         correlation_id: nil,
+        # Header param: Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Header param: Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # Header param: For use by platforms to specify an account id and set scope of a

data/rbi/straddle/resources/customers/review.rbi

@@ -13,6 +13,7 @@ module Straddle
             id: String,
             status: Straddle::Customers::ReviewDecisionParams::Status::OrSymbol,
             correlation_id: String,
+            idempotency_key: String,
             request_id: String,
             straddle_account_id: String,
             request_options: Straddle::RequestOptions::OrHash
@@ -26,6 +27,8 @@ module Straddle
           # Header param: Optional client generated identifier to trace and debug a series
           # of requests.
           correlation_id: nil,
+          # Header param: Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
           # Header param: Optional client generated identifier to trace and debug a request.
           request_id: nil,
           # Header param: For use by platforms to specify an account id and set scope of a

data/rbi/straddle/resources/customers.rbi

@@ -28,6 +28,7 @@ module Straddle
           external_id: T.nilable(String),
           metadata: T.nilable(T::Hash[Symbol, String]),
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -63,6 +64,8 @@ module Straddle
         # Header param: Optional client generated identifier to trace and debug a series
         # of requests.
         correlation_id: nil,
+        # Header param: Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Header param: Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # Header param: For use by platforms to specify an account id and set scope of a
@@ -93,6 +96,7 @@ module Straddle
           external_id: T.nilable(String),
           metadata: T.nilable(T::Hash[Symbol, String]),
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -126,6 +130,8 @@ module Straddle
         # Header param: Optional client generated identifier to trace and debug a series
         # of requests.
         correlation_id: nil,
+        # Header param: Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Header param: Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # Header param: For use by platforms to specify an account id and set scope of a
@@ -207,6 +213,7 @@ module Straddle
         params(
           id: String,
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -216,6 +223,8 @@ module Straddle
         id,
         # Optional client generated identifier to trace and debug a series of requests.
         correlation_id: nil,
+        # Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # For use by platforms to specify an account id and set scope of a request.
@@ -255,6 +264,7 @@ module Straddle
         params(
           id: String,
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -264,6 +274,8 @@ module Straddle
         id,
         # Optional client generated identifier to trace and debug a series of requests.
         correlation_id: nil,
+        # Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # For use by platforms to specify an account id and set scope of a request.

data/rbi/straddle/resources/embed/accounts/capability_requests.rbi

@@ -23,6 +23,7 @@ module Straddle
               signed_agreement:
                 Straddle::Embed::Accounts::CapabilityRequestCreateParams::SignedAgreement::OrHash,
               correlation_id: String,
+              idempotency_key: String,
               request_id: String,
               request_options: Straddle::RequestOptions::OrHash
             ).returns(Straddle::Embed::Accounts::CapabilityRequestPagedV1)
@@ -47,6 +48,8 @@ module Straddle
             # Header param: Optional client generated identifier to trace and debug a series
             # of requests.
             correlation_id: nil,
+            # Header param: Optional client generated value to use for idempotent requests.
+            idempotency_key: nil,
             # Header param: Optional client generated identifier to trace and debug a request.
             request_id: nil,
             request_options: {}

data/rbi/straddle/resources/embed/accounts.rbi

@@ -23,6 +23,7 @@ module Straddle
             external_id: T.nilable(String),
             metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
             correlation_id: String,
+            idempotency_key: String,
             request_id: String,
             request_options: Straddle::RequestOptions::OrHash
           ).returns(Straddle::Embed::AccountV1)
@@ -47,6 +48,8 @@ module Straddle
           # Header param: Optional client generated identifier to trace and debug a series
           # of requests.
           correlation_id: nil,
+          # Header param: Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
           # Header param: Optional client generated identifier to trace and debug a request.
           request_id: nil,
           request_options: {}
@@ -62,6 +65,7 @@ module Straddle
             external_id: T.nilable(String),
             metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
             correlation_id: String,
+            idempotency_key: String,
             request_id: String,
             request_options: Straddle::RequestOptions::OrHash
           ).returns(Straddle::Embed::AccountV1)
@@ -80,6 +84,8 @@ module Straddle
           # Header param: Optional client generated identifier to trace and debug a series
           # of requests.
           correlation_id: nil,
+          # Header param: Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
           # Header param: Optional client generated identifier to trace and debug a request.
           request_id: nil,
           request_options: {}
@@ -162,6 +168,7 @@ module Straddle
             account_id: String,
             terms_of_service: Straddle::Embed::TermsOfServiceV1::OrHash,
             correlation_id: String,
+            idempotency_key: String,
             request_id: String,
             request_options: Straddle::RequestOptions::OrHash
           ).returns(Straddle::Embed::AccountV1)
@@ -174,6 +181,8 @@ module Straddle
           # Header param: Optional client generated identifier to trace and debug a series
           # of requests.
           correlation_id: nil,
+          # Header param: Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
           # Header param: Optional client generated identifier to trace and debug a request.
           request_id: nil,
           request_options: {}
@@ -188,6 +197,7 @@ module Straddle
             final_status:
               Straddle::Embed::AccountSimulateParams::FinalStatus::OrSymbol,
             correlation_id: String,
+            idempotency_key: String,
             request_id: String,
             request_options: Straddle::RequestOptions::OrHash
           ).returns(Straddle::Embed::AccountV1)
@@ -200,6 +210,8 @@ module Straddle
           # Header param: Optional client generated identifier to trace and debug a series
           # of requests.
           correlation_id: nil,
+          # Header param: Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
           # Header param: Optional client generated identifier to trace and debug a request.
           request_id: nil,
           request_options: {}

data/rbi/straddle/resources/embed/linked_bank_accounts.rbi

@@ -10,11 +10,20 @@ module Straddle
         # more.
         sig do
           params(
-            account_id: String,
+            account_id: T.nilable(String),
             bank_account:
               Straddle::Embed::LinkedBankAccountCreateParams::BankAccount::OrHash,
+            description: T.nilable(String),
             metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
+            platform_id: T.nilable(String),
+            purposes:
+              T.nilable(
+                T::Array[
+                  Straddle::Embed::LinkedBankAccountCreateParams::Purpose::OrSymbol
+                ]
+              ),
             correlation_id: String,
+            idempotency_key: String,
             request_id: String,
             request_options: Straddle::RequestOptions::OrHash
           ).returns(Straddle::Embed::LinkedBankAccountV1)
@@ -25,12 +34,21 @@ module Straddle
           account_id:,
           # Body param:
           bank_account:,
+          # Body param: Optional description for the bank account.
+          description: nil,
           # Body param: Up to 20 additional user-defined key-value pairs. Useful for storing
           # additional information about the linked bank account in a structured format.
           metadata: nil,
+          # Body param: The unique identifier of the Straddle Platform to associate this
+          # bank account with.
+          platform_id: nil,
+          # Body param: The purposes for the linked bank account.
+          purposes: nil,
           # Header param: Optional client generated identifier to trace and debug a series
           # of requests.
           correlation_id: nil,
+          # Header param: Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
           # Header param: Optional client generated identifier to trace and debug a request.
           request_id: nil,
           request_options: {}
@@ -48,6 +66,7 @@ module Straddle
               Straddle::Embed::LinkedBankAccountUpdateParams::BankAccount::OrHash,
             metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
             correlation_id: String,
+            idempotency_key: String,
             request_id: String,
             request_options: Straddle::RequestOptions::OrHash
           ).returns(Straddle::Embed::LinkedBankAccountV1)
@@ -63,6 +82,8 @@ module Straddle
           # Header param: Optional client generated identifier to trace and debug a series
           # of requests.
           correlation_id: nil,
+          # Header param: Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
           # Header param: Optional client generated identifier to trace and debug a request.
           request_id: nil,
           request_options: {}
@@ -114,6 +135,30 @@ module Straddle
         )
         end
 
+        # Cancels an existing linked bank account. This can be used to cancel a linked
+        # bank account before it has been reviewed. The linked bank account must be in
+        # 'created' status.
+        sig do
+          params(
+            linked_bank_account_id: String,
+            correlation_id: String,
+            idempotency_key: String,
+            request_id: String,
+            request_options: Straddle::RequestOptions::OrHash
+          ).returns(Straddle::Embed::LinkedBankAccountV1)
+        end
+        def cancel(
+          linked_bank_account_id,
+          # Optional client generated identifier to trace and debug a series of requests.
+          correlation_id: nil,
+          # Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
+          # Optional client generated identifier to trace and debug a request.
+          request_id: nil,
+          request_options: {}
+        )
+        end
+
         # Retrieves the details of a linked bank account that has previously been created.
         # Supply the unique linked bank account `id`, and Straddle will return the
         # corresponding information. The response includes masked account details for

data/rbi/straddle/resources/embed/organizations.rbi

@@ -13,6 +13,7 @@ module Straddle
             external_id: T.nilable(String),
             metadata: T.nilable(T::Hash[Symbol, T.nilable(String)]),
             correlation_id: String,
+            idempotency_key: String,
             request_id: String,
             request_options: Straddle::RequestOptions::OrHash
           ).returns(Straddle::Embed::OrganizationV1)
@@ -29,6 +30,8 @@ module Straddle
           # Header param: Optional client generated identifier to trace and debug a series
           # of requests.
           correlation_id: nil,
+          # Header param: Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
           # Header param: Optional client generated identifier to trace and debug a request.
           request_id: nil,
           request_options: {}

data/rbi/straddle/resources/embed/representatives.rbi

@@ -19,7 +19,9 @@ module Straddle
               Straddle::Embed::RepresentativeCreateParams::Relationship::OrHash,
             ssn_last4: String,
             external_id: T.nilable(String),
+            metadata: T.nilable(T::Hash[Symbol, String]),
             correlation_id: String,
+            idempotency_key: String,
             request_id: String,
             request_options: Straddle::RequestOptions::OrHash
           ).returns(Straddle::Embed::Representative)
@@ -46,9 +48,14 @@ module Straddle
           # Body param: Unique identifier for the representative in your database, used for
           # cross-referencing between Straddle and your systems.
           external_id: nil,
+          # Body param: Up to 20 additional user-defined key-value pairs. Useful for storing
+          # additional information about the represetative in a structured format.
+          metadata: nil,
           # Header param: Optional client generated identifier to trace and debug a series
           # of requests.
           correlation_id: nil,
+          # Header param: Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
           # Header param: Optional client generated identifier to trace and debug a request.
           request_id: nil,
           request_options: {}
@@ -70,7 +77,9 @@ module Straddle
               Straddle::Embed::RepresentativeUpdateParams::Relationship::OrHash,
             ssn_last4: String,
             external_id: T.nilable(String),
+            metadata: T.nilable(T::Hash[Symbol, String]),
             correlation_id: String,
+            idempotency_key: String,
             request_id: String,
             request_options: Straddle::RequestOptions::OrHash
           ).returns(Straddle::Embed::Representative)
@@ -96,9 +105,14 @@ module Straddle
           # Body param: Unique identifier for the representative in your database, used for
           # cross-referencing between Straddle and your systems.
           external_id: nil,
+          # Body param: Up to 20 additional user-defined key-value pairs. Useful for storing
+          # additional information about the represetative in a structured format.
+          metadata: nil,
           # Header param: Optional client generated identifier to trace and debug a series
           # of requests.
           correlation_id: nil,
+          # Header param: Optional client generated value to use for idempotent requests.
+          idempotency_key: nil,
           # Header param: Optional client generated identifier to trace and debug a request.
           request_id: nil,
           request_options: {}

data/rbi/straddle/resources/paykeys.rbi

@@ -56,6 +56,7 @@ module Straddle
           id: String,
           reason: T.nilable(String),
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -69,6 +70,8 @@ module Straddle
         # Header param: Optional client generated identifier to trace and debug a series
         # of requests.
         correlation_id: nil,
+        # Header param: Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Header param: Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # Header param: For use by platforms to specify an account id and set scope of a
@@ -127,6 +130,37 @@ module Straddle
       )
       end
 
+      # Update the status of a paykey when in review status
+      sig do
+        params(
+          id: String,
+          status: Straddle::PaykeyReviewParams::Status::OrSymbol,
+          correlation_id: String,
+          idempotency_key: String,
+          request_id: String,
+          straddle_account_id: String,
+          request_options: Straddle::RequestOptions::OrHash
+        ).returns(Straddle::PaykeyV1)
+      end
+      def review(
+        # Path param:
+        id,
+        # Body param:
+        status:,
+        # Header param: Optional client generated identifier to trace and debug a series
+        # of requests.
+        correlation_id: nil,
+        # Header param: Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
+        # Header param: Optional client generated identifier to trace and debug a request.
+        request_id: nil,
+        # Header param: For use by platforms to specify an account id and set scope of a
+        # request.
+        straddle_account_id: nil,
+        request_options: {}
+      )
+      end
+
       # Retrieves the unmasked details of an existing paykey. Supply the unique paykey
       # `id` and Straddle will return the corresponding paykey record, including the
       # unmasked bank account details. This endpoint needs to be enabled by Straddle for

data/rbi/straddle/resources/payouts.rbi

@@ -16,6 +16,7 @@ module Straddle
           config: Straddle::PayoutCreateParams::Config::OrHash,
           metadata: T.nilable(T::Hash[Symbol, String]),
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -47,6 +48,8 @@ module Straddle
         # Header param: Optional client generated identifier to trace and debug a series
         # of requests.
         correlation_id: nil,
+        # Header param: Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Header param: Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # Header param: For use by platforms to specify an account id and set scope of a
@@ -66,6 +69,7 @@ module Straddle
           payment_date: Date,
           metadata: T.nilable(T::Hash[Symbol, String]),
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -87,6 +91,8 @@ module Straddle
         # Header param: Optional client generated identifier to trace and debug a series
         # of requests.
         correlation_id: nil,
+        # Header param: Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Header param: Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # Header param: For use by platforms to specify an account id and set scope of a
@@ -103,6 +109,7 @@ module Straddle
           id: String,
           reason: String,
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -116,6 +123,8 @@ module Straddle
         # Header param: Optional client generated identifier to trace and debug a series
         # of requests.
         correlation_id: nil,
+        # Header param: Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Header param: Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # Header param: For use by platforms to specify an account id and set scope of a
@@ -155,6 +164,7 @@ module Straddle
           id: String,
           reason: String,
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -168,6 +178,8 @@ module Straddle
         # Header param: Optional client generated identifier to trace and debug a series
         # of requests.
         correlation_id: nil,
+        # Header param: Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Header param: Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # Header param: For use by platforms to specify an account id and set scope of a
@@ -184,6 +196,7 @@ module Straddle
           id: String,
           reason: String,
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions::OrHash
@@ -197,6 +210,8 @@ module Straddle
         # Header param: Optional client generated identifier to trace and debug a series
         # of requests.
         correlation_id: nil,
+        # Header param: Optional client generated value to use for idempotent requests.
+        idempotency_key: nil,
         # Header param: Optional client generated identifier to trace and debug a request.
         request_id: nil,
         # Header param: For use by platforms to specify an account id and set scope of a