straddle 0.2.0 → 0.3.0

data/lib/straddle/models/payment_summary_paged_v1.rb

@@ -111,6 +111,12 @@ module Straddle
         #   @return [Straddle::Models::StatusDetailsV1]
         required :status_details, -> { Straddle::StatusDetailsV1 }
 
+        # @!attribute trace_ids
+        #   Trace ids.
+        #
+        #   @return [Hash{Symbol=>String}]
+        required :trace_ids, Straddle::Internal::Type::HashOf[String]
+
         # @!attribute updated_at
         #   The time the `charge` or `payout` was last updated.
         #
@@ -144,7 +150,7 @@ module Straddle
         #   @return [Straddle::Models::PaykeyDetailsV1, nil]
         optional :paykey_details, -> { Straddle::PaykeyDetailsV1 }
 
-        # @!method initialize(id:, amount:, created_at:, currency:, description:, external_id:, funding_ids:, paykey:, payment_date:, payment_type:, status:, status_details:, updated_at:, customer_details: nil, effective_at: nil, funding_id: nil, paykey_details: nil)
+        # @!method initialize(id:, amount:, created_at:, currency:, description:, external_id:, funding_ids:, paykey:, payment_date:, payment_type:, status:, status_details:, trace_ids:, updated_at:, customer_details: nil, effective_at: nil, funding_id: nil, paykey_details: nil)
         #   Some parameter documentations has been truncated, see
         #   {Straddle::Models::PaymentSummaryPagedV1::Data} for more details.
         #
@@ -172,6 +178,8 @@ module Straddle
         #
         #   @param status_details [Straddle::Models::StatusDetailsV1] Details about the current status of the `charge` or `payout`.
         #
+        #   @param trace_ids [Hash{Symbol=>String}] Trace ids.
+        #
         #   @param updated_at [Time] The time the `charge` or `payout` was last updated.
         #
         #   @param customer_details [Straddle::Models::CustomerDetailsV1] Information about the customer associated with the charge or payout.

data/lib/straddle/models.rb

@@ -73,8 +73,6 @@ module Straddle
 
   CustomerListParams = Straddle::Models::CustomerListParams
 
-  CustomerRefreshReviewParams = Straddle::Models::CustomerRefreshReviewParams
-
   Customers = Straddle::Models::Customers
 
   CustomerSummaryPagedV1 = Straddle::Models::CustomerSummaryPagedV1
@@ -113,7 +111,7 @@ module Straddle
 
   PaykeyRevealParams = Straddle::Models::PaykeyRevealParams
 
-  PaykeyReviewParams = Straddle::Models::PaykeyReviewParams
+  Paykeys = Straddle::Models::Paykeys
 
   PaykeySummaryPagedV1 = Straddle::Models::PaykeySummaryPagedV1
 
@@ -121,6 +119,8 @@ module Straddle
 
   PaykeyUnmaskedV1 = Straddle::Models::PaykeyUnmaskedV1
 
+  PaykeyUpdateBalanceParams = Straddle::Models::PaykeyUpdateBalanceParams
+
   PaykeyV1 = Straddle::Models::PaykeyV1
 
   PaymentListParams = Straddle::Models::PaymentListParams

data/lib/straddle/resources/bridge/link.rb

@@ -11,7 +11,7 @@ module Straddle
         # source. This endpoint allows you to create a secure payment token linked to a
         # specific bank account.
         #
-        # @overload bank_account(account_number:, account_type:, customer_id:, routing_number:, config: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+        # @overload bank_account(account_number:, account_type:, customer_id:, routing_number:, config: nil, external_id: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
         #
         # @param account_number [String] Body param: The bank account number.
         #
@@ -23,6 +23,8 @@ module Straddle
         #
         # @param config [Straddle::Models::Bridge::LinkBankAccountParams::Config] Body param:
         #
+        # @param external_id [String, nil] Body param: Unique identifier for the paykey in your database, used for cross-re
+        #
         # @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
@@ -64,7 +66,7 @@ module Straddle
         # you to create a secure payment token linked to a bank account authenticated
         # through Quiltt.
         #
-        # @overload create_paykey(customer_id:, quiltt_token:, config: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+        # @overload create_paykey(customer_id:, quiltt_token:, config: nil, external_id: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
         #
         # @param customer_id [String] Body param: Unique identifier of the related customer object.
         #
@@ -72,6 +74,8 @@ module Straddle
         #
         # @param config [Straddle::Models::Bridge::LinkCreatePaykeyParams::Config] Body param:
         #
+        # @param external_id [String, nil] Body param: Unique identifier for the paykey in your database, used for cross-re
+        #
         # @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
@@ -109,7 +113,7 @@ module Straddle
         # Some parameter documentations has been truncated, see
         # {Straddle::Models::Bridge::LinkCreateTanParams} for more details.
         #
-        # @overload create_tan(account_type:, customer_id:, routing_number:, tan:, config: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+        # @overload create_tan(account_type:, customer_id:, routing_number:, tan:, config: nil, external_id: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
         #
         # @param account_type [Symbol, Straddle::Models::Bridge::LinkCreateTanParams::AccountType] Body param:
         #
@@ -121,6 +125,8 @@ module Straddle
         #
         # @param config [Straddle::Models::Bridge::LinkCreateTanParams::Config] Body param:
         #
+        # @param external_id [String, nil] Body param: Unique identifier for the paykey in your database, used for cross-re
+        #
         # @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
@@ -162,7 +168,7 @@ module Straddle
         # endpoint allows you to create a secure payment token linked to a bank account
         # authenticated through Plaid.
         #
-        # @overload plaid(customer_id:, plaid_token:, config: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+        # @overload plaid(customer_id:, plaid_token:, config: nil, external_id: nil, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
         #
         # @param customer_id [String] Body param: Unique identifier of the related customer object.
         #
@@ -170,6 +176,8 @@ module Straddle
         #
         # @param config [Straddle::Models::Bridge::LinkPlaidParams::Config] Body param:
         #
+        # @param external_id [String, nil] Body param: Unique identifier for the paykey in your database, used for cross-re
+        #
         # @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

data/lib/straddle/resources/bridge.rb

@@ -11,12 +11,14 @@ module Straddle
       #
       # Use this endpoint to generate a session token for use in the Bridge widget.
       #
-      # @overload initialize_(customer_id:, config: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @overload initialize_(customer_id:, config: nil, external_id: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
       # @param customer_id [String] Body param: The Straddle generated unique identifier of the `customer` to create
       #
       # @param config [Straddle::Models::BridgeInitializeParams::Config] Body param:
       #
+      # @param external_id [String, nil] Body param: Unique identifier for the paykey in your database, used for cross-re
+      #
       # @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.

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

@@ -90,6 +90,43 @@ module Straddle
           )
         end
 
+        # Updates the decision of a customer's identity validation. This endpoint allows
+        # you to modify the outcome of a customer decision and is useful for correcting or
+        # updating the status of a customer'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::CustomerV1]
+        #
+        # @see Straddle::Models::Customers::ReviewRefreshReviewParams
+        def refresh_review(id, params = {})
+          parsed, options = Straddle::Customers::ReviewRefreshReviewParams.dump_request(params)
+          @client.request(
+            method: :put,
+            path: ["v1/customers/%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::CustomerV1,
+            options: options
+          )
+        end
+
         # @api private
         #
         # @param client [Straddle::Client]

data/lib/straddle/resources/customers.rb

@@ -276,43 +276,6 @@ module Straddle
         )
       end
 
-      # Updates the decision of a customer's identity validation. This endpoint allows
-      # you to modify the outcome of a customer decision and is useful for correcting or
-      # updating the status of a customer'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::CustomerV1]
-      #
-      # @see Straddle::Models::CustomerRefreshReviewParams
-      def refresh_review(id, params = {})
-        parsed, options = Straddle::CustomerRefreshReviewParams.dump_request(params)
-        @client.request(
-          method: :put,
-          path: ["v1/customers/%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::CustomerV1,
-          options: options
-        )
-      end
-
       # Retrieves the unmasked details, including PII, of an existing customer. Supply
       # the unique customer ID that was returned from your 'create customer' request,
       # and Straddle will return the corresponding customer information. This endpoint

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

@@ -100,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.
         #
@@ -110,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.
@@ -125,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",

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.
       #
@@ -164,80 +167,73 @@ module Straddle
         )
       end
 
-      # Some parameter documentations has been truncated, see
-      # {Straddle::Models::PaykeyReviewParams} for more details.
-      #
-      # Update the status of a paykey when in review status
-      #
-      # @overload review(id, status:, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
-      #
-      # @param id [String] Path param:
+      # 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
+      # your account and should only be used when absolutely necessary.
       #
-      # @param status [Symbol, Straddle::Models::PaykeyReviewParams::Status] Body param:
+      # @overload unmasked(id, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
-      # @param correlation_id [String] Header param: Optional client generated identifier to trace and debug a series o
+      # @param id [String]
       #
-      # @param idempotency_key [String] Header param: Optional client generated value to use for idempotent requests.
+      # @param correlation_id [String] Optional client generated identifier to trace and debug a series of requests.
       #
-      # @param request_id [String] Header param: Optional client generated identifier to trace and debug a request.
+      # @param request_id [String] 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 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]
+      # @return [Straddle::Models::PaykeyUnmaskedV1]
       #
-      # @see Straddle::Models::PaykeyReviewParams
-      def review(id, params)
-        parsed, options = Straddle::PaykeyReviewParams.dump_request(params)
-        header_params =
-          {
+      # @see Straddle::Models::PaykeyUnmaskedParams
+      def unmasked(id, params = {})
+        parsed, options = Straddle::PaykeyUnmaskedParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: ["v1/paykeys/%1$s/unmasked", id],
+          headers: parsed.transform_keys(
             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,
+          ),
+          model: Straddle::PaykeyUnmaskedV1,
           options: 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
-      # your account and should only be used when absolutely necessary.
+      # Updates the balance of a paykey. This endpoint allows you to refresh the balance
+      # of a paykey.
       #
-      # @overload unmasked(id, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @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::PaykeyUnmaskedV1]
+      # @return [Straddle::Models::PaykeyV1]
       #
-      # @see Straddle::Models::PaykeyUnmaskedParams
-      def unmasked(id, params = {})
-        parsed, options = Straddle::PaykeyUnmaskedParams.dump_request(params)
+      # @see Straddle::Models::PaykeyUpdateBalanceParams
+      def update_balance(id, params = {})
+        parsed, options = Straddle::PaykeyUpdateBalanceParams.dump_request(params)
         @client.request(
-          method: :get,
-          path: ["v1/paykeys/%1$s/unmasked", id],
+          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::PaykeyUnmaskedV1,
+          model: Straddle::PaykeyV1,
           options: options
         )
       end
@@ -247,6 +243,7 @@ module Straddle
       # @param client [Straddle::Client]
       def initialize(client:)
         @client = client
+        @review = Straddle::Resources::Paykeys::Review.new(client: client)
       end
     end
   end

data/lib/straddle/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Straddle
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/straddle.rb

@@ -9,6 +9,7 @@ require "erb"
 require "etc"
 require "json"
 require "net/http"
+require "openssl"
 require "pathname"
 require "rbconfig"
 require "securerandom"
@@ -74,11 +75,11 @@ require_relative "straddle/models/customer_delete_params"
 require_relative "straddle/models/customer_details_v1"
 require_relative "straddle/models/customer_get_params"
 require_relative "straddle/models/customer_list_params"
-require_relative "straddle/models/customer_refresh_review_params"
 require_relative "straddle/models/customers/customer_review_v1"
 require_relative "straddle/models/customers/identity_verification_breakdown_v1"
 require_relative "straddle/models/customers/review_decision_params"
 require_relative "straddle/models/customers/review_get_params"
+require_relative "straddle/models/customers/review_refresh_review_params"
 require_relative "straddle/models/customer_summary_paged_v1"
 require_relative "straddle/models/customer_unmasked_params"
 require_relative "straddle/models/customer_unmasked_v1"
@@ -135,10 +136,14 @@ require_relative "straddle/models/paykey_get_params"
 require_relative "straddle/models/paykey_list_params"
 require_relative "straddle/models/paykey_reveal_params"
 require_relative "straddle/models/paykey_reveal_response"
-require_relative "straddle/models/paykey_review_params"
+require_relative "straddle/models/paykeys/review_decision_params"
+require_relative "straddle/models/paykeys/review_get_params"
+require_relative "straddle/models/paykeys/review_get_response"
+require_relative "straddle/models/paykeys/review_refresh_review_params"
 require_relative "straddle/models/paykey_summary_paged_v1"
 require_relative "straddle/models/paykey_unmasked_params"
 require_relative "straddle/models/paykey_unmasked_v1"
+require_relative "straddle/models/paykey_update_balance_params"
 require_relative "straddle/models/paykey_v1"
 require_relative "straddle/models/payment_list_params"
 require_relative "straddle/models/payment_summary_paged_v1"
@@ -169,6 +174,7 @@ require_relative "straddle/resources/embed/organizations"
 require_relative "straddle/resources/embed/representatives"
 require_relative "straddle/resources/funding_events"
 require_relative "straddle/resources/paykeys"
+require_relative "straddle/resources/paykeys/review"
 require_relative "straddle/resources/payments"
 require_relative "straddle/resources/payouts"
 require_relative "straddle/resources/reports"

data/manifest.yaml

@@ -6,6 +6,7 @@ dependencies:
   - etc
   - json
   - net/http
+  - openssl
   - pathname
   - rbconfig
   - securerandom

data/rbi/straddle/internal/transport/base_client.rbi

@@ -176,6 +176,11 @@ module Straddle
         private def auth_headers
         end
 
+        # @api private
+        sig { returns(String) }
+        private def user_agent
+        end
+
         # @api private
         sig { returns(String) }
         private def generate_idempotency_key

data/rbi/straddle/internal/transport/pooled_net_requester.rbi

@@ -26,8 +26,12 @@ module Straddle
 
         class << self
           # @api private
-          sig { params(url: URI::Generic).returns(Net::HTTP) }
-          def connect(url)
+          sig do
+            params(cert_store: OpenSSL::X509::Store, url: URI::Generic).returns(
+              Net::HTTP
+            )
+          end
+          def connect(cert_store:, url:)
           end
 
           # @api private