straddle 0.1.1 → 0.3.0

data/lib/straddle/resources/embed/accounts/capability_requests.rb

@@ -12,7 +12,7 @@ module Straddle
           # Submits a request to enable a specific capability for an account. Use this
           # endpoint to request additional features or services for an account.
           #
-          # @overload create(account_id, businesses: nil, charges: nil, individuals: nil, internet: nil, payouts: nil, signed_agreement: nil, correlation_id: nil, request_id: nil, request_options: {})
+          # @overload create(account_id, businesses: nil, charges: nil, individuals: nil, internet: nil, payouts: nil, signed_agreement: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, request_options: {})
           #
           # @param account_id [String] Path param:
           #
@@ -30,6 +30,8 @@ module Straddle
           #
           # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
           #
+          # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+          #
           # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
           #
           # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -39,7 +41,8 @@ module Straddle
           # @see Straddle::Models::Embed::Accounts::CapabilityRequestCreateParams
           def create(account_id, params = {})
             parsed, options = Straddle::Embed::Accounts::CapabilityRequestCreateParams.dump_request(params)
-            header_params = {correlation_id: "correlation-id", request_id: "request-id"}
+            header_params =
+              {correlation_id: "correlation-id", idempotency_key: "idempotency-key", request_id: "request-id"}
             @client.request(
               method: :post,
               path: ["v1/accounts/%1$s/capability_requests", account_id],

data/lib/straddle/resources/embed/accounts.rb

@@ -14,7 +14,7 @@ module Straddle
         # endpoint allows you to set up an account with specified details, including
         # business information and access levels.
         #
-        # @overload create(access_level:, account_type:, business_profile:, organization_id:, external_id: nil, metadata: nil, correlation_id: nil, request_id: nil, request_options: {})
+        # @overload create(access_level:, account_type:, business_profile:, organization_id:, external_id: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, request_options: {})
         #
         # @param access_level [Symbol, Straddle::Models::Embed::AccountCreateParams::AccessLevel] Body param: The access level granted to the account. This is determined by your
         #
@@ -30,6 +30,8 @@ module Straddle
         #
         # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
         #
+        # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+        #
         # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
         #
         # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -39,7 +41,8 @@ module Straddle
         # @see Straddle::Models::Embed::AccountCreateParams
         def create(params)
           parsed, options = Straddle::Embed::AccountCreateParams.dump_request(params)
-          header_params = {correlation_id: "correlation-id", request_id: "request-id"}
+          header_params =
+            {correlation_id: "correlation-id", idempotency_key: "idempotency-key", request_id: "request-id"}
           @client.request(
             method: :post,
             path: "v1/accounts",
@@ -56,7 +59,7 @@ module Straddle
         # Updates an existing account's information. This endpoint allows you to update
         # various account details during onboarding or after the account has been created.
         #
-        # @overload update(account_id, business_profile:, external_id: nil, metadata: nil, correlation_id: nil, request_id: nil, request_options: {})
+        # @overload update(account_id, business_profile:, external_id: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, request_options: {})
         #
         # @param account_id [String] Path param:
         #
@@ -68,6 +71,8 @@ module Straddle
         #
         # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
         #
+        # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+        #
         # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
         #
         # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -77,7 +82,8 @@ module Straddle
         # @see Straddle::Models::Embed::AccountUpdateParams
         def update(account_id, params)
           parsed, options = Straddle::Embed::AccountUpdateParams.dump_request(params)
-          header_params = {correlation_id: "correlation-id", request_id: "request-id"}
+          header_params =
+            {correlation_id: "correlation-id", idempotency_key: "idempotency-key", request_id: "request-id"}
           @client.request(
             method: :put,
             path: ["v1/accounts/%1$s", account_id],
@@ -173,7 +179,7 @@ module Straddle
         # used for accounts where at least one representative and one bank account have
         # already been created.
         #
-        # @overload onboard(account_id, terms_of_service:, correlation_id: nil, request_id: nil, request_options: {})
+        # @overload onboard(account_id, terms_of_service:, correlation_id: nil, idempotency_key: nil, request_id: nil, request_options: {})
         #
         # @param account_id [String] Path param:
         #
@@ -181,6 +187,8 @@ module Straddle
         #
         # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
         #
+        # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+        #
         # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
         #
         # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -190,7 +198,8 @@ module Straddle
         # @see Straddle::Models::Embed::AccountOnboardParams
         def onboard(account_id, params)
           parsed, options = Straddle::Embed::AccountOnboardParams.dump_request(params)
-          header_params = {correlation_id: "correlation-id", request_id: "request-id"}
+          header_params =
+            {correlation_id: "correlation-id", idempotency_key: "idempotency-key", request_id: "request-id"}
           @client.request(
             method: :post,
             path: ["v1/accounts/%1$s/onboard", account_id],
@@ -207,7 +216,7 @@ module Straddle
         # Simulate the status transitions for sandbox accounts. This endpoint can only be
         # used for sandbox accounts.
         #
-        # @overload simulate(account_id, final_status: nil, correlation_id: nil, request_id: nil, request_options: {})
+        # @overload simulate(account_id, final_status: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, request_options: {})
         #
         # @param account_id [String] Path param:
         #
@@ -215,6 +224,8 @@ module Straddle
         #
         # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
         #
+        # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+        #
         # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
         #
         # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -231,6 +242,7 @@ module Straddle
             query: parsed.slice(*query_params),
             headers: parsed.except(*query_params).transform_keys(
               correlation_id: "correlation-id",
+              idempotency_key: "idempotency-key",
               request_id: "request-id"
             ),
             model: Straddle::Embed::AccountV1,

data/lib/straddle/resources/embed/linked_bank_accounts.rb

@@ -12,16 +12,24 @@ module Straddle
         # for various payment operations such as payment deposits, payout withdrawals, and
         # more.
         #
-        # @overload create(account_id:, bank_account:, metadata: nil, correlation_id: nil, request_id: nil, request_options: {})
+        # @overload create(account_id:, bank_account:, description: nil, metadata: nil, platform_id: nil, purposes: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, request_options: {})
         #
-        # @param account_id [String] Body param: The unique identifier of the Straddle account to associate this bank
+        # @param account_id [String, nil] Body param: The unique identifier of the Straddle account to associate this bank
         #
         # @param bank_account [Straddle::Models::Embed::LinkedBankAccountCreateParams::BankAccount] Body param:
         #
+        # @param description [String, nil] Body param: Optional description for the bank account.
+        #
         # @param metadata [Hash{Symbol=>String, nil}, nil] Body param: Up to 20 additional user-defined key-value pairs. Useful for storing
         #
+        # @param platform_id [String, nil] Body param: The unique identifier of the Straddle Platform to associate this ban
+        #
+        # @param purposes [Array<Symbol, Straddle::Models::Embed::LinkedBankAccountCreateParams::Purpose>, nil] Body param: The purposes for the linked bank account.
+        #
         # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
         #
+        # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+        #
         # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
         #
         # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -31,7 +39,8 @@ module Straddle
         # @see Straddle::Models::Embed::LinkedBankAccountCreateParams
         def create(params)
           parsed, options = Straddle::Embed::LinkedBankAccountCreateParams.dump_request(params)
-          header_params = {correlation_id: "correlation-id", request_id: "request-id"}
+          header_params =
+            {correlation_id: "correlation-id", idempotency_key: "idempotency-key", request_id: "request-id"}
           @client.request(
             method: :post,
             path: "v1/linked_bank_accounts",
@@ -50,7 +59,7 @@ module Straddle
         # the linked account. The linked bank account must be in 'created' or 'onboarding'
         # status.
         #
-        # @overload update(linked_bank_account_id, bank_account:, metadata: nil, correlation_id: nil, request_id: nil, request_options: {})
+        # @overload update(linked_bank_account_id, bank_account:, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, request_options: {})
         #
         # @param linked_bank_account_id [String] Path param:
         #
@@ -60,6 +69,8 @@ module Straddle
         #
         # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
         #
+        # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+        #
         # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
         #
         # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -69,7 +80,8 @@ module Straddle
         # @see Straddle::Models::Embed::LinkedBankAccountUpdateParams
         def update(linked_bank_account_id, params)
           parsed, options = Straddle::Embed::LinkedBankAccountUpdateParams.dump_request(params)
-          header_params = {correlation_id: "correlation-id", request_id: "request-id"}
+          header_params =
+            {correlation_id: "correlation-id", idempotency_key: "idempotency-key", request_id: "request-id"}
           @client.request(
             method: :put,
             path: ["v1/linked_bank_accounts/%1$s", linked_bank_account_id],
@@ -88,7 +100,7 @@ module Straddle
         # recently created appearing first. This endpoint supports pagination to handle
         # accounts with multiple linked bank accounts.
         #
-        # @overload list(account_id: nil, level: nil, page_number: nil, page_size: nil, sort_by: nil, sort_order: nil, correlation_id: nil, request_id: nil, request_options: {})
+        # @overload list(account_id: nil, level: nil, page_number: nil, page_size: nil, purpose: nil, sort_by: nil, sort_order: nil, status: nil, correlation_id: nil, request_id: nil, request_options: {})
         #
         # @param account_id [String] Query param: The unique identifier of the related account.
         #
@@ -98,10 +110,14 @@ module Straddle
         #
         # @param page_size [Integer] Query param: Page size. Max value: 1000
         #
+        # @param purpose [Symbol, Straddle::Models::Embed::LinkedBankAccountListParams::Purpose] Query param: The purpose of the linked bank accounts to return. Possible values:
+        #
         # @param sort_by [String] Query param: Sort By.
         #
         # @param sort_order [Symbol, Straddle::Models::Embed::LinkedBankAccountListParams::SortOrder] Query param: Sort Order.
         #
+        # @param status [Symbol, Straddle::Models::Embed::LinkedBankAccountListParams::Status] Query param: The status of the linked bank accounts to return. Possible values:
+        #
         # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
         #
         # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
@@ -113,7 +129,16 @@ module Straddle
         # @see Straddle::Models::Embed::LinkedBankAccountListParams
         def list(params = {})
           parsed, options = Straddle::Embed::LinkedBankAccountListParams.dump_request(params)
-          query_params = [:account_id, :level, :page_number, :page_size, :sort_by, :sort_order]
+          query_params = [
+            :account_id,
+            :level,
+            :page_number,
+            :page_size,
+            :purpose,
+            :sort_by,
+            :sort_order,
+            :status
+          ]
           @client.request(
             method: :get,
             path: "v1/linked_bank_accounts",
@@ -128,6 +153,40 @@ 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.
+        #
+        # @overload cancel(linked_bank_account_id, correlation_id: nil, idempotency_key: nil, request_id: nil, request_options: {})
+        #
+        # @param linked_bank_account_id [String]
+        #
+        # @param correlation_id [String] Optional client generated identifier to trace and debug a series of requests.
+        #
+        # @param idempotency_key [String] Optional client generated value to use for idempotent requests.
+        #
+        # @param request_id [String] Optional client generated identifier to trace and debug a request.
+        #
+        # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Straddle::Models::Embed::LinkedBankAccountV1]
+        #
+        # @see Straddle::Models::Embed::LinkedBankAccountCancelParams
+        def cancel(linked_bank_account_id, params = {})
+          parsed, options = Straddle::Embed::LinkedBankAccountCancelParams.dump_request(params)
+          @client.request(
+            method: :patch,
+            path: ["v1/linked_bank_accounts/%1$s/cancel", linked_bank_account_id],
+            headers: parsed.transform_keys(
+              correlation_id: "correlation-id",
+              idempotency_key: "idempotency-key",
+              request_id: "request-id"
+            ),
+            model: Straddle::Embed::LinkedBankAccountV1,
+            options: 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/lib/straddle/resources/embed/organizations.rb

@@ -11,7 +11,7 @@ module Straddle
         # can be used to group related accounts and manage permissions across multiple
         # users.
         #
-        # @overload create(name:, external_id: nil, metadata: nil, correlation_id: nil, request_id: nil, request_options: {})
+        # @overload create(name:, external_id: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, request_options: {})
         #
         # @param name [String] Body param: The name of the organization.
         #
@@ -21,6 +21,8 @@ module Straddle
         #
         # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
         #
+        # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+        #
         # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
         #
         # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -30,7 +32,8 @@ module Straddle
         # @see Straddle::Models::Embed::OrganizationCreateParams
         def create(params)
           parsed, options = Straddle::Embed::OrganizationCreateParams.dump_request(params)
-          header_params = {correlation_id: "correlation-id", request_id: "request-id"}
+          header_params =
+            {correlation_id: "correlation-id", idempotency_key: "idempotency-key", request_id: "request-id"}
           @client.request(
             method: :post,
             path: "v1/organizations",

data/lib/straddle/resources/embed/representatives.rb

@@ -11,7 +11,7 @@ module Straddle
         # individuals who have legal authority or significant responsibility within the
         # business.
         #
-        # @overload create(account_id:, dob:, email:, first_name:, last_name:, mobile_number:, relationship:, ssn_last4:, external_id: nil, correlation_id: nil, request_id: nil, request_options: {})
+        # @overload create(account_id:, dob:, email:, first_name:, last_name:, mobile_number:, relationship:, ssn_last4:, external_id: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, request_options: {})
         #
         # @param account_id [String] Body param: The unique identifier of the account this representative is associat
         #
@@ -31,8 +31,12 @@ module Straddle
         #
         # @param external_id [String, nil] Body param: Unique identifier for the representative in your database, used for
         #
+        # @param metadata [Hash{Symbol=>String}, nil] Body param: Up to 20 additional user-defined key-value pairs. Useful for storing
+        #
         # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
         #
+        # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+        #
         # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
         #
         # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -42,7 +46,8 @@ module Straddle
         # @see Straddle::Models::Embed::RepresentativeCreateParams
         def create(params)
           parsed, options = Straddle::Embed::RepresentativeCreateParams.dump_request(params)
-          header_params = {correlation_id: "correlation-id", request_id: "request-id"}
+          header_params =
+            {correlation_id: "correlation-id", idempotency_key: "idempotency-key", request_id: "request-id"}
           @client.request(
             method: :post,
             path: "v1/representatives",
@@ -60,7 +65,7 @@ module Straddle
         # personal details, contact information, or the relationship to the account or
         # organization.
         #
-        # @overload update(representative_id, dob:, email:, first_name:, last_name:, mobile_number:, relationship:, ssn_last4:, external_id: nil, correlation_id: nil, request_id: nil, request_options: {})
+        # @overload update(representative_id, dob:, email:, first_name:, last_name:, mobile_number:, relationship:, ssn_last4:, external_id: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, request_options: {})
         #
         # @param representative_id [String] Path param:
         #
@@ -80,8 +85,12 @@ module Straddle
         #
         # @param external_id [String, nil] Body param: Unique identifier for the representative in your database, used for
         #
+        # @param metadata [Hash{Symbol=>String}, nil] Body param: Up to 20 additional user-defined key-value pairs. Useful for storing
+        #
         # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
         #
+        # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+        #
         # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
         #
         # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -91,7 +100,8 @@ module Straddle
         # @see Straddle::Models::Embed::RepresentativeUpdateParams
         def update(representative_id, params)
           parsed, options = Straddle::Embed::RepresentativeUpdateParams.dump_request(params)
-          header_params = {correlation_id: "correlation-id", request_id: "request-id"}
+          header_params =
+            {correlation_id: "correlation-id", idempotency_key: "idempotency-key", request_id: "request-id"}
           @client.request(
             method: :put,
             path: ["v1/representatives/%1$s", representative_id],

data/lib/straddle/resources/funding_events.rb

@@ -9,7 +9,7 @@ module Straddle
       # Retrieves a list of funding events for your account. This endpoint supports
       # advanced sorting and filtering options.
       #
-      # @overload list(created_from: nil, created_to: nil, direction: nil, event_type: nil, page_number: nil, page_size: nil, sort_by: nil, sort_order: nil, trace_number: nil, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @overload list(created_from: nil, created_to: nil, direction: nil, event_type: nil, page_number: nil, page_size: nil, search_text: nil, sort_by: nil, sort_order: nil, trace_number: nil, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
       # @param created_from [Date, nil] Query param: The start date of the range to filter by using the `YYYY-MM-DD` for
       #
@@ -23,6 +23,8 @@ module Straddle
       #
       # @param page_size [Integer] Query param: Results page size. Max value: 1000
       #
+      # @param search_text [String, nil] Query param: Search text.
+      #
       # @param sort_by [Symbol, Straddle::Models::FundingEventListParams::SortBy] Query param: The field to sort the results by.
       #
       # @param sort_order [Symbol, Straddle::Models::FundingEventListParams::SortOrder] Query param: The order in which to sort the results.
@@ -50,6 +52,7 @@ module Straddle
             :event_type,
             :page_number,
             :page_size,
+            :search_text,
             :sort_by,
             :sort_order,
             :trace_number

data/lib/straddle/resources/paykeys/review.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+module Straddle
+  module Resources
+    class Paykeys
+      class Review
+        # Some parameter documentations has been truncated, see
+        # {Straddle::Models::Paykeys::ReviewDecisionParams} for more details.
+        #
+        # Update the status of a paykey when in review status
+        #
+        # @overload decision(id, status:, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+        #
+        # @param id [String] Path param:
+        #
+        # @param status [Symbol, Straddle::Models::Paykeys::ReviewDecisionParams::Status] Body param:
+        #
+        # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
+        #
+        # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+        #
+        # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
+        #
+        # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
+        #
+        # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Straddle::Models::PaykeyV1]
+        #
+        # @see Straddle::Models::Paykeys::ReviewDecisionParams
+        def decision(id, params)
+          parsed, options = Straddle::Paykeys::ReviewDecisionParams.dump_request(params)
+          header_params =
+            {
+              correlation_id: "correlation-id",
+              idempotency_key: "idempotency-key",
+              request_id: "request-id",
+              straddle_account_id: "straddle-account-id"
+            }
+          @client.request(
+            method: :patch,
+            path: ["v1/paykeys/%1$s/review", id],
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
+            model: Straddle::PaykeyV1,
+            options: options
+          )
+        end
+
+        # Get additional details about a paykey.
+        #
+        # @overload get(id, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+        #
+        # @param id [String]
+        #
+        # @param correlation_id [String] Optional client generated identifier to trace and debug a series of requests.
+        #
+        # @param request_id [String] Optional client generated identifier to trace and debug a request.
+        #
+        # @param straddle_account_id [String] For use by platforms to specify an account id and set scope of a request.
+        #
+        # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Straddle::Models::Paykeys::ReviewGetResponse]
+        #
+        # @see Straddle::Models::Paykeys::ReviewGetParams
+        def get(id, params = {})
+          parsed, options = Straddle::Paykeys::ReviewGetParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: ["v1/paykeys/%1$s/review", id],
+            headers: parsed.transform_keys(
+              correlation_id: "correlation-id",
+              request_id: "request-id",
+              straddle_account_id: "straddle-account-id"
+            ),
+            model: Straddle::Models::Paykeys::ReviewGetResponse,
+            options: options
+          )
+        end
+
+        # Updates the decision of a paykey's review validation. This endpoint allows you
+        # to refresh the outcome of a paykey's decision and is useful for correcting or
+        # updating the status of a paykey's verification.
+        #
+        # @overload refresh_review(id, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+        #
+        # @param id [String]
+        #
+        # @param correlation_id [String] Optional client generated identifier to trace and debug a series of requests.
+        #
+        # @param idempotency_key [String] Optional client generated value to use for idempotent requests.
+        #
+        # @param request_id [String] Optional client generated identifier to trace and debug a request.
+        #
+        # @param straddle_account_id [String] For use by platforms to specify an account id and set scope of a request.
+        #
+        # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Straddle::Models::PaykeyV1]
+        #
+        # @see Straddle::Models::Paykeys::ReviewRefreshReviewParams
+        def refresh_review(id, params = {})
+          parsed, options = Straddle::Paykeys::ReviewRefreshReviewParams.dump_request(params)
+          @client.request(
+            method: :put,
+            path: ["v1/paykeys/%1$s/refresh_review", id],
+            headers: parsed.transform_keys(
+              correlation_id: "correlation-id",
+              idempotency_key: "idempotency-key",
+              request_id: "request-id",
+              straddle_account_id: "straddle-account-id"
+            ),
+            model: Straddle::PaykeyV1,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Straddle::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/straddle/resources/paykeys.rb

@@ -3,6 +3,9 @@
 module Straddle
   module Resources
     class Paykeys
+      # @return [Straddle::Resources::Paykeys::Review]
+      attr_reader :review
+
       # Some parameter documentations has been truncated, see
       # {Straddle::Models::PaykeyListParams} for more details.
       #
@@ -57,7 +60,7 @@ module Straddle
       # Some parameter documentations has been truncated, see
       # {Straddle::Models::PaykeyCancelParams} for more details.
       #
-      # @overload cancel(id, reason: nil, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @overload cancel(id, reason: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
       # @param id [String] Path param:
       #
@@ -65,6 +68,8 @@ module Straddle
       #
       # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
       #
+      # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+      #
       # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
       #
       # @param straddle_account_id [String] Header param: For use by platforms to specify an account id and set scope of a r
@@ -79,6 +84,7 @@ module Straddle
         header_params =
           {
             correlation_id: "correlation-id",
+            idempotency_key: "idempotency-key",
             request_id: "request-id",
             straddle_account_id: "straddle-account-id"
           }
@@ -196,11 +202,48 @@ module Straddle
         )
       end
 
+      # Updates the balance of a paykey. This endpoint allows you to refresh the balance
+      # of a paykey.
+      #
+      # @overload update_balance(id, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      #
+      # @param id [String]
+      #
+      # @param correlation_id [String] Optional client generated identifier to trace and debug a series of requests.
+      #
+      # @param idempotency_key [String] Optional client generated value to use for idempotent requests.
+      #
+      # @param request_id [String] Optional client generated identifier to trace and debug a request.
+      #
+      # @param straddle_account_id [String] For use by platforms to specify an account id and set scope of a request.
+      #
+      # @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Straddle::Models::PaykeyV1]
+      #
+      # @see Straddle::Models::PaykeyUpdateBalanceParams
+      def update_balance(id, params = {})
+        parsed, options = Straddle::PaykeyUpdateBalanceParams.dump_request(params)
+        @client.request(
+          method: :put,
+          path: ["v1/paykeys/%1$s/refresh_balance", id],
+          headers: parsed.transform_keys(
+            correlation_id: "correlation-id",
+            idempotency_key: "idempotency-key",
+            request_id: "request-id",
+            straddle_account_id: "straddle-account-id"
+          ),
+          model: Straddle::PaykeyV1,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [Straddle::Client]
       def initialize(client:)
         @client = client
+        @review = Straddle::Resources::Paykeys::Review.new(client: client)
       end
     end
   end