straddle 0.1.0.pre.alpha.1 → 0.2.0

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

data/sig/straddle/client.rbs

@@ -9,8 +9,8 @@ module Straddle
     DEFAULT_MAX_RETRY_DELAY: Float
 
     ENVIRONMENTS: {
-      production: "https://production.straddle.io",
-      sandbox: "https://sandbox.straddle.io"
+      sandbox: "https://sandbox.straddle.com",
+      production: "https://production.straddle.com"
     }
 
     attr_reader api_key: String
@@ -37,7 +37,7 @@ module Straddle
 
     def initialize: (
       ?api_key: String?,
-      ?environment: :production | :sandbox | nil,
+      ?environment: :sandbox | :production | nil,
       ?base_url: String?,
       ?max_retries: Integer,
       ?timeout: Float,

data/sig/straddle/errors.rbs

@@ -21,11 +21,14 @@ module Straddle
 
       attr_accessor status: Integer?
 
+      attr_accessor headers: ::Hash[String, String]?
+
       attr_accessor body: top?
 
       def initialize: (
         url: URI::Generic,
         ?status: Integer?,
+        ?headers: ::Hash[String, String]?,
         ?body: Object?,
         ?request: nil,
         ?response: nil,
@@ -37,6 +40,7 @@ module Straddle
       def initialize: (
         url: URI::Generic,
         ?status: nil,
+        ?headers: ::Hash[String, String]?,
         ?body: nil,
         ?request: nil,
         ?response: nil,
@@ -48,6 +52,7 @@ module Straddle
       def initialize: (
         url: URI::Generic,
         ?status: nil,
+        ?headers: ::Hash[String, String]?,
         ?body: nil,
         ?request: nil,
         ?response: nil,
@@ -59,6 +64,7 @@ module Straddle
       def self.for: (
         url: URI::Generic,
         status: Integer,
+        headers: ::Hash[String, String]?,
         body: Object?,
         request: nil,
         response: nil,
@@ -68,6 +74,7 @@ module Straddle
       def initialize: (
         url: URI::Generic,
         status: Integer,
+        headers: ::Hash[String, String]?,
         body: Object?,
         request: nil,
         response: nil,

data/sig/straddle/file_part.rbs

@@ -14,7 +14,7 @@ module Straddle
 
     def initialize: (
       Pathname | StringIO | IO | String content,
-      ?filename: String?,
+      ?filename: (Pathname | String)?,
       ?content_type: String?
     ) -> void
   end

data/sig/straddle/internal/transport/base_client.rbs

@@ -99,7 +99,7 @@ module Straddle
           retry_count: Integer
         ) -> Float
 
-        private def send_request: (
+        def send_request: (
           Straddle::Internal::Transport::BaseClient::request_input request,
           redirect_count: Integer,
           retry_count: Integer,

data/sig/straddle/internal/type/converter.rbs

@@ -39,6 +39,23 @@ module Straddle
           | Straddle::Internal::Type::Converter::input spec
         ) -> (^-> top)
 
+        def self.meta_info: (
+          {
+            const: (nil | bool | Integer | Float | Symbol)?,
+            enum: ^-> Straddle::Internal::Type::Converter::input?,
+            union: ^-> Straddle::Internal::Type::Converter::input?
+          }
+          | ^-> Straddle::Internal::Type::Converter::input
+          | Straddle::Internal::Type::Converter::input type_info,
+          {
+            const: (nil | bool | Integer | Float | Symbol)?,
+            enum: ^-> Straddle::Internal::Type::Converter::input?,
+            union: ^-> Straddle::Internal::Type::Converter::input?
+          }
+          | ^-> Straddle::Internal::Type::Converter::input
+          | Straddle::Internal::Type::Converter::input spec
+        ) -> ::Hash[Symbol, top]
+
         def self.new_coerce_state: (
           ?translate_names: bool
         ) -> Straddle::Internal::Type::Converter::coerce_state

data/sig/straddle/internal/type/union.rbs

@@ -5,9 +5,9 @@ module Straddle
         include Straddle::Internal::Type::Converter
         include Straddle::Internal::Util::SorbetRuntimeSupport
 
-        private def self.known_variants: -> ::Array[[Symbol?, (^-> Straddle::Internal::Type::Converter::input)]]
+        private def self.known_variants: -> ::Array[[Symbol?, (^-> Straddle::Internal::Type::Converter::input), ::Hash[Symbol, top]]]
 
-        def self.derefed_variants: -> ::Array[[Symbol?, top]]
+        def self.derefed_variants: -> ::Array[[Symbol?, top, ::Hash[Symbol, top]]]
 
         def self.variants: -> ::Array[top]
 

data/sig/straddle/models/bridge/link_bank_account_params.rbs

@@ -10,6 +10,7 @@ module Straddle
           config: Straddle::Bridge::LinkBankAccountParams::Config,
           metadata: ::Hash[Symbol, String]?,
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String
         }
@@ -39,6 +40,10 @@ module Straddle
 
         def correlation_id=: (String) -> String
 
+        attr_reader idempotency_key: String?
+
+        def idempotency_key=: (String) -> String
+
         attr_reader request_id: String?
 
         def request_id=: (String) -> String
@@ -55,6 +60,7 @@ module Straddle
           ?config: Straddle::Bridge::LinkBankAccountParams::Config,
           ?metadata: ::Hash[Symbol, String]?,
           ?correlation_id: String,
+          ?idempotency_key: String,
           ?request_id: String,
           ?straddle_account_id: String,
           ?request_options: Straddle::request_opts
@@ -68,6 +74,7 @@ module Straddle
           config: Straddle::Bridge::LinkBankAccountParams::Config,
           metadata: ::Hash[Symbol, String]?,
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions

data/sig/straddle/models/bridge/link_create_paykey_params.rbs

@@ -8,6 +8,7 @@ module Straddle
           config: Straddle::Bridge::LinkCreatePaykeyParams::Config,
           metadata: ::Hash[Symbol, String]?,
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String
         }
@@ -33,6 +34,10 @@ module Straddle
 
         def correlation_id=: (String) -> String
 
+        attr_reader idempotency_key: String?
+
+        def idempotency_key=: (String) -> String
+
         attr_reader request_id: String?
 
         def request_id=: (String) -> String
@@ -47,6 +52,7 @@ module Straddle
           ?config: Straddle::Bridge::LinkCreatePaykeyParams::Config,
           ?metadata: ::Hash[Symbol, String]?,
           ?correlation_id: String,
+          ?idempotency_key: String,
           ?request_id: String,
           ?straddle_account_id: String,
           ?request_options: Straddle::request_opts
@@ -58,6 +64,7 @@ module Straddle
           config: Straddle::Bridge::LinkCreatePaykeyParams::Config,
           metadata: ::Hash[Symbol, String]?,
           correlation_id: String,
+          idempotency_key: String,
           request_id: String,
           straddle_account_id: String,
           request_options: Straddle::RequestOptions