straddle 0.4.0 → 0.5.0

data/lib/straddle/models/payout_unmask_response.rb

@@ -85,6 +85,24 @@ module Straddle
         #   @return [Array<String>]
         required :funding_ids, Straddle::Internal::Type::ArrayOf[String]
 
+        # @!attribute has_resubmit
+        #   Has the payout been resubmitted.
+        #
+        #   @return [Boolean]
+        required :has_resubmit, Straddle::Internal::Type::Boolean
+
+        # @!attribute is_refund
+        #   Is the payout a refund of an original charge.
+        #
+        #   @return [Boolean]
+        required :is_refund, Straddle::Internal::Type::Boolean
+
+        # @!attribute is_resubmit
+        #   Is the payout a resubmit of an original payout.
+        #
+        #   @return [Boolean]
+        required :is_resubmit, Straddle::Internal::Type::Boolean
+
         # @!attribute paykey
         #   Paykey.
         #
@@ -133,6 +151,15 @@ module Straddle
         #   @return [Straddle::Models::CustomerDetailsV1, nil]
         optional :customer_details, -> { Straddle::CustomerDetailsV1 }
 
+        # @!attribute documents
+        #   Documents uploaded for this payout (e.g. proof of authorization), in the order
+        #   they were uploaded.
+        #
+        #   @return [Array<Straddle::Models::PayoutUnmaskResponse::Data::Document>, nil]
+        optional :documents,
+                 -> { Straddle::Internal::Type::ArrayOf[Straddle::Models::PayoutUnmaskResponse::Data::Document] },
+                 nil?: true
+
         # @!attribute effective_at
         #   Effective at.
         #
@@ -165,9 +192,9 @@ module Straddle
         # @!attribute related_payments
         #   Related payments.
         #
-        #   @return [Hash{Symbol=>Symbol, Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment}, nil]
+        #   @return [Array<Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment>, nil]
         optional :related_payments,
-                 -> { Straddle::Internal::Type::HashOf[enum: Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment] },
+                 -> { Straddle::Internal::Type::ArrayOf[Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment] },
                  nil?: true
 
         # @!attribute updated_at
@@ -176,7 +203,10 @@ module Straddle
         #   @return [Time, nil]
         optional :updated_at, Time, nil?: true
 
-        # @!method initialize(id:, amount:, config:, currency:, description:, device:, external_id:, funding_ids:, paykey:, payment_date:, status:, status_details:, status_history:, trace_ids:, created_at: nil, customer_details: nil, effective_at: nil, metadata: nil, paykey_details: nil, payment_rail: nil, processed_at: nil, related_payments: nil, updated_at: nil)
+        # @!method initialize(id:, amount:, config:, currency:, description:, device:, external_id:, funding_ids:, has_resubmit:, is_refund:, is_resubmit:, paykey:, payment_date:, status:, status_details:, status_history:, trace_ids:, created_at: nil, customer_details: nil, documents: nil, effective_at: nil, metadata: nil, paykey_details: nil, payment_rail: nil, processed_at: nil, related_payments: nil, updated_at: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Straddle::Models::PayoutUnmaskResponse::Data} for more details.
+        #
         #   @param id [String] Id.
         #
         #   @param amount [Integer] Amount.
@@ -193,6 +223,12 @@ module Straddle
         #
         #   @param funding_ids [Array<String>] Funding Ids
         #
+        #   @param has_resubmit [Boolean] Has the payout been resubmitted.
+        #
+        #   @param is_refund [Boolean] Is the payout a refund of an original charge.
+        #
+        #   @param is_resubmit [Boolean] Is the payout a resubmit of an original payout.
+        #
         #   @param paykey [String] Paykey.
         #
         #   @param payment_date [Date] Payment date.
@@ -209,6 +245,8 @@ module Straddle
         #
         #   @param customer_details [Straddle::Models::CustomerDetailsV1] Information about the customer associated with the charge or payout.
         #
+        #   @param documents [Array<Straddle::Models::PayoutUnmaskResponse::Data::Document>, nil] Documents uploaded for this payout (e.g. proof of authorization), in the order t
+        #
         #   @param effective_at [Time, nil] Effective at.
         #
         #   @param metadata [Hash{Symbol=>String}, nil] Metadata.
@@ -219,7 +257,7 @@ module Straddle
         #
         #   @param processed_at [Time, nil] Processed at.
         #
-        #   @param related_payments [Hash{Symbol=>Symbol, Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment}, nil] Related payments.
+        #   @param related_payments [Array<Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment>, nil] Related payments.
         #
         #   @param updated_at [Time, nil] Updated at.
 
@@ -268,6 +306,8 @@ module Straddle
             REVERSED_CUSTOMER_DISPUTE = :reversed_customer_dispute
             FAILED_CLOSED_BANK_ACCOUNT = :failed_closed_bank_account
             REVERSED_CLOSED_BANK_ACCOUNT = :reversed_closed_bank_account
+            FAILED_NOT_AUTHORIZED = :failed_not_authorized
+            REVERSED_NOT_AUTHORIZED = :reversed_not_authorized
 
             # @!method self.values
             #   @return [Array<Symbol>]
@@ -438,6 +478,58 @@ module Straddle
           end
         end
 
+        class Document < Straddle::Internal::Type::BaseModel
+          # @!attribute document_id
+          #   Unique identifier for this document.
+          #
+          #   @return [String]
+          required :document_id, String
+
+          # @!attribute document_name
+          #   The file name of this document as uploaded.
+          #
+          #   @return [String]
+          required :document_name, String
+
+          # @!attribute document_size
+          #   The size of this document in bytes.
+          #
+          #   @return [Integer]
+          required :document_size, Integer
+
+          # @!attribute document_type
+          #
+          #   @return [Symbol, Straddle::Models::PayoutUnmaskResponse::Data::Document::DocumentType]
+          required :document_type, enum: -> { Straddle::Models::PayoutUnmaskResponse::Data::Document::DocumentType }
+
+          # @!attribute uploaded_at
+          #   The UTC timestamp when this document was uploaded.
+          #
+          #   @return [Time]
+          required :uploaded_at, Time
+
+          # @!method initialize(document_id:, document_name:, document_size:, document_type:, uploaded_at:)
+          #   @param document_id [String] Unique identifier for this document.
+          #
+          #   @param document_name [String] The file name of this document as uploaded.
+          #
+          #   @param document_size [Integer] The size of this document in bytes.
+          #
+          #   @param document_type [Symbol, Straddle::Models::PayoutUnmaskResponse::Data::Document::DocumentType]
+          #
+          #   @param uploaded_at [Time] The UTC timestamp when this document was uploaded.
+
+          # @see Straddle::Models::PayoutUnmaskResponse::Data::Document#document_type
+          module DocumentType
+            extend Straddle::Internal::Type::Enum
+
+            PAYMENT_AUTHORIZATION = :payment_authorization
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
         # The payment rail used for the charge or payout.
         #
         # @see Straddle::Models::PayoutUnmaskResponse::Data#payment_rail
@@ -450,15 +542,57 @@ module Straddle
           #   @return [Array<Symbol>]
         end
 
-        module RelatedPayment
-          extend Straddle::Internal::Type::Enum
+        class RelatedPayment < Straddle::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of the related payment.
+          #
+          #   @return [String]
+          required :id, String
 
-          ORIGINAL = :original
-          RESUBMIT = :resubmit
-          REFUND = :refund
+          # @!attribute payment_type
+          #   The type of payment.
+          #
+          #   @return [Symbol, Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::PaymentType]
+          required :payment_type,
+                   enum: -> { Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::PaymentType }
 
-          # @!method self.values
-          #   @return [Array<Symbol>]
+          # @!attribute relationship
+          #
+          #   @return [Symbol, Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::Relationship]
+          required :relationship,
+                   enum: -> { Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::Relationship }
+
+          # @!method initialize(id:, payment_type:, relationship:)
+          #   @param id [String] The ID of the related payment.
+          #
+          #   @param payment_type [Symbol, Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::PaymentType] The type of payment.
+          #
+          #   @param relationship [Symbol, Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::Relationship]
+
+          # The type of payment.
+          #
+          # @see Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment#payment_type
+          module PaymentType
+            extend Straddle::Internal::Type::Enum
+
+            CHARGE = :charge
+            PAYOUT = :payout
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment#relationship
+          module Relationship
+            extend Straddle::Internal::Type::Enum
+
+            ORIGINAL = :original
+            RESUBMIT = :resubmit
+            REFUND = :refund
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
 

data/lib/straddle/models/payout_upload_authorization_document_params.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Straddle
+  module Models
+    # @see Straddle::Resources::Payouts#upload_authorization_document
+    class PayoutUploadAuthorizationDocumentParams < Straddle::Internal::Type::BaseModel
+      extend Straddle::Internal::Type::RequestParameters::Converter
+      include Straddle::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute file
+      #   The document file to upload as proof of authorization for this payout.
+      #
+      #   @return [Pathname, StringIO, IO, String, Straddle::FilePart]
+      required :file, Straddle::Internal::Type::FileInput, api_name: :File
+
+      # @!attribute correlation_id
+      #
+      #   @return [String, nil]
+      optional :correlation_id, String
+
+      # @!attribute idempotency_key
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!attribute request_id
+      #
+      #   @return [String, nil]
+      optional :request_id, String
+
+      # @!attribute straddle_account_id
+      #
+      #   @return [String, nil]
+      optional :straddle_account_id, String
+
+      # @!method initialize(id:, file:, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      #   @param id [String]
+      #
+      #   @param file [Pathname, StringIO, IO, String, Straddle::FilePart] The document file to upload as proof of authorization for this payout.
+      #
+      #   @param correlation_id [String]
+      #
+      #   @param idempotency_key [String]
+      #
+      #   @param request_id [String]
+      #
+      #   @param straddle_account_id [String]
+      #
+      #   @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/straddle/models/payout_v1.rb

@@ -88,6 +88,24 @@ module Straddle
         #   @return [Array<String>]
         required :funding_ids, Straddle::Internal::Type::ArrayOf[String]
 
+        # @!attribute has_resubmit
+        #   Has the payout been resubmitted.
+        #
+        #   @return [Boolean]
+        required :has_resubmit, Straddle::Internal::Type::Boolean
+
+        # @!attribute is_refund
+        #   Is the payout a refund of an original charge.
+        #
+        #   @return [Boolean]
+        required :is_refund, Straddle::Internal::Type::Boolean
+
+        # @!attribute is_resubmit
+        #   Is the payout a resubmit of an original payout.
+        #
+        #   @return [Boolean]
+        required :is_resubmit, Straddle::Internal::Type::Boolean
+
         # @!attribute paykey
         #   Value of the `paykey` used for the payout.
         #
@@ -138,6 +156,15 @@ module Straddle
         #   @return [Straddle::Models::CustomerDetailsV1, nil]
         optional :customer_details, -> { Straddle::CustomerDetailsV1 }
 
+        # @!attribute documents
+        #   Documents uploaded for this payout (e.g. proof of authorization), in the order
+        #   they were uploaded.
+        #
+        #   @return [Array<Straddle::Models::PayoutV1::Data::Document>, nil]
+        optional :documents,
+                 -> { Straddle::Internal::Type::ArrayOf[Straddle::PayoutV1::Data::Document] },
+                 nil?: true
+
         # @!attribute effective_at
         #   The actual date on which the payment occurred. For payouts, this is the date the
         #   funds were sent from your bank account.
@@ -174,9 +201,9 @@ module Straddle
         # @!attribute related_payments
         #   Related payments.
         #
-        #   @return [Hash{Symbol=>Symbol, Straddle::Models::PayoutV1::Data::RelatedPayment}, nil]
+        #   @return [Array<Straddle::Models::PayoutV1::Data::RelatedPayment>, nil]
         optional :related_payments,
-                 -> { Straddle::Internal::Type::HashOf[enum: Straddle::PayoutV1::Data::RelatedPayment] },
+                 -> { Straddle::Internal::Type::ArrayOf[Straddle::PayoutV1::Data::RelatedPayment] },
                  nil?: true
 
         # @!attribute updated_at
@@ -185,7 +212,7 @@ module Straddle
         #   @return [Time, nil]
         optional :updated_at, Time, nil?: true
 
-        # @!method initialize(id:, amount:, config:, currency:, description:, device:, external_id:, funding_ids:, paykey:, payment_date:, status:, status_details:, status_history:, trace_ids:, created_at: nil, customer_details: nil, effective_at: nil, metadata: nil, paykey_details: nil, payment_rail: nil, processed_at: nil, related_payments: nil, updated_at: nil)
+        # @!method initialize(id:, amount:, config:, currency:, description:, device:, external_id:, funding_ids:, has_resubmit:, is_refund:, is_resubmit:, paykey:, payment_date:, status:, status_details:, status_history:, trace_ids:, created_at: nil, customer_details: nil, documents: nil, effective_at: nil, metadata: nil, paykey_details: nil, payment_rail: nil, processed_at: nil, related_payments: nil, updated_at: nil)
         #   Some parameter documentations has been truncated, see
         #   {Straddle::Models::PayoutV1::Data} for more details.
         #
@@ -205,6 +232,12 @@ module Straddle
         #
         #   @param funding_ids [Array<String>] Funding Ids
         #
+        #   @param has_resubmit [Boolean] Has the payout been resubmitted.
+        #
+        #   @param is_refund [Boolean] Is the payout a refund of an original charge.
+        #
+        #   @param is_resubmit [Boolean] Is the payout a resubmit of an original payout.
+        #
         #   @param paykey [String] Value of the `paykey` used for the payout.
         #
         #   @param payment_date [Date] The desired date on which the payment should be occur. For payouts, this means t
@@ -221,6 +254,8 @@ module Straddle
         #
         #   @param customer_details [Straddle::Models::CustomerDetailsV1] Information about the customer associated with the payout.
         #
+        #   @param documents [Array<Straddle::Models::PayoutV1::Data::Document>, nil] Documents uploaded for this payout (e.g. proof of authorization), in the order t
+        #
         #   @param effective_at [Time, nil] The actual date on which the payment occurred. For payouts, this is the date the
         #
         #   @param metadata [Hash{Symbol=>String}, nil] Up to 20 additional user-defined key-value pairs. Useful for storing additional
@@ -231,7 +266,7 @@ module Straddle
         #
         #   @param processed_at [Time, nil] The time the payout was processed by Straddle and originated to the payment rail
         #
-        #   @param related_payments [Hash{Symbol=>Symbol, Straddle::Models::PayoutV1::Data::RelatedPayment}, nil] Related payments.
+        #   @param related_payments [Array<Straddle::Models::PayoutV1::Data::RelatedPayment>, nil] Related payments.
         #
         #   @param updated_at [Time, nil] The time the payout was last updated.
 
@@ -281,6 +316,8 @@ module Straddle
             REVERSED_CUSTOMER_DISPUTE = :reversed_customer_dispute
             FAILED_CLOSED_BANK_ACCOUNT = :failed_closed_bank_account
             REVERSED_CLOSED_BANK_ACCOUNT = :reversed_closed_bank_account
+            FAILED_NOT_AUTHORIZED = :failed_not_authorized
+            REVERSED_NOT_AUTHORIZED = :reversed_not_authorized
 
             # @!method self.values
             #   @return [Array<Symbol>]
@@ -439,6 +476,58 @@ module Straddle
           end
         end
 
+        class Document < Straddle::Internal::Type::BaseModel
+          # @!attribute document_id
+          #   Unique identifier for this document.
+          #
+          #   @return [String]
+          required :document_id, String
+
+          # @!attribute document_name
+          #   The file name of this document as uploaded.
+          #
+          #   @return [String]
+          required :document_name, String
+
+          # @!attribute document_size
+          #   The size of this document in bytes.
+          #
+          #   @return [Integer]
+          required :document_size, Integer
+
+          # @!attribute document_type
+          #
+          #   @return [Symbol, Straddle::Models::PayoutV1::Data::Document::DocumentType]
+          required :document_type, enum: -> { Straddle::PayoutV1::Data::Document::DocumentType }
+
+          # @!attribute uploaded_at
+          #   The UTC timestamp when this document was uploaded.
+          #
+          #   @return [Time]
+          required :uploaded_at, Time
+
+          # @!method initialize(document_id:, document_name:, document_size:, document_type:, uploaded_at:)
+          #   @param document_id [String] Unique identifier for this document.
+          #
+          #   @param document_name [String] The file name of this document as uploaded.
+          #
+          #   @param document_size [Integer] The size of this document in bytes.
+          #
+          #   @param document_type [Symbol, Straddle::Models::PayoutV1::Data::Document::DocumentType]
+          #
+          #   @param uploaded_at [Time] The UTC timestamp when this document was uploaded.
+
+          # @see Straddle::Models::PayoutV1::Data::Document#document_type
+          module DocumentType
+            extend Straddle::Internal::Type::Enum
+
+            PAYMENT_AUTHORIZATION = :payment_authorization
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
         # The payment rail used for the payout.
         #
         # @see Straddle::Models::PayoutV1::Data#payment_rail
@@ -451,15 +540,55 @@ module Straddle
           #   @return [Array<Symbol>]
         end
 
-        module RelatedPayment
-          extend Straddle::Internal::Type::Enum
+        class RelatedPayment < Straddle::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of the related payment.
+          #
+          #   @return [String]
+          required :id, String
 
-          ORIGINAL = :original
-          RESUBMIT = :resubmit
-          REFUND = :refund
+          # @!attribute payment_type
+          #   The type of payment.
+          #
+          #   @return [Symbol, Straddle::Models::PayoutV1::Data::RelatedPayment::PaymentType]
+          required :payment_type, enum: -> { Straddle::PayoutV1::Data::RelatedPayment::PaymentType }
 
-          # @!method self.values
-          #   @return [Array<Symbol>]
+          # @!attribute relationship
+          #
+          #   @return [Symbol, Straddle::Models::PayoutV1::Data::RelatedPayment::Relationship]
+          required :relationship, enum: -> { Straddle::PayoutV1::Data::RelatedPayment::Relationship }
+
+          # @!method initialize(id:, payment_type:, relationship:)
+          #   @param id [String] The ID of the related payment.
+          #
+          #   @param payment_type [Symbol, Straddle::Models::PayoutV1::Data::RelatedPayment::PaymentType] The type of payment.
+          #
+          #   @param relationship [Symbol, Straddle::Models::PayoutV1::Data::RelatedPayment::Relationship]
+
+          # The type of payment.
+          #
+          # @see Straddle::Models::PayoutV1::Data::RelatedPayment#payment_type
+          module PaymentType
+            extend Straddle::Internal::Type::Enum
+
+            CHARGE = :charge
+            PAYOUT = :payout
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Straddle::Models::PayoutV1::Data::RelatedPayment#relationship
+          module Relationship
+            extend Straddle::Internal::Type::Enum
+
+            ORIGINAL = :original
+            RESUBMIT = :resubmit
+            REFUND = :refund
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
 

data/lib/straddle/models.rb

@@ -141,6 +141,8 @@ module Straddle
 
   PayoutUpdateParams = Straddle::Models::PayoutUpdateParams
 
+  PayoutUploadAuthorizationDocumentParams = Straddle::Models::PayoutUploadAuthorizationDocumentParams
+
   PayoutV1 = Straddle::Models::PayoutV1
 
   ReportCreateTotalCustomersByStatusParams = Straddle::Models::ReportCreateTotalCustomersByStatusParams

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

@@ -111,7 +111,9 @@ module Straddle
         # created accounts appearing first. This endpoint supports advanced sorting and
         # filtering options.
         #
-        # @overload list(page_number: nil, page_size: nil, search_text: nil, sort_by: nil, sort_order: nil, status: nil, type: nil, correlation_id: nil, request_id: nil, request_options: {})
+        # @overload list(external_id: nil, page_number: nil, page_size: nil, search_text: nil, sort_by: nil, sort_order: nil, status: nil, type: nil, correlation_id: nil, request_id: nil, request_options: {})
+        #
+        # @param external_id [String] Query param
         #
         # @param page_number [Integer] Query param: Results page number. Starts at page 1. Default value: 1
         #
@@ -137,7 +139,8 @@ module Straddle
         #
         # @see Straddle::Models::Embed::AccountListParams
         def list(params = {})
-          query_params = [:page_number, :page_size, :search_text, :sort_by, :sort_order, :status, :type]
+          query_params =
+            [:external_id, :page_number, :page_size, :search_text, :sort_by, :sort_order, :status, :type]
           parsed, options = Straddle::Embed::AccountListParams.dump_request(params)
           query = Straddle::Internal::Util.encode_query_params(parsed.slice(*query_params))
           @client.request(

data/lib/straddle/resources/paykeys.rb

@@ -22,7 +22,11 @@ module Straddle
       # Returns a list of paykeys associated with a Straddle account. This endpoint
       # supports advanced sorting and filtering options.
       #
-      # @overload list(customer_id: nil, page_number: nil, page_size: nil, search_text: nil, sort_by: nil, sort_order: nil, source: nil, status: nil, unblock_eligible: nil, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @overload list(created_from: nil, created_to: nil, customer_id: nil, page_number: nil, page_size: nil, search_text: nil, sort_by: nil, sort_order: nil, source: nil, status: nil, unblock_eligible: nil, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      #
+      # @param created_from [Time] Query param: Start date for filtering by creation date.
+      #
+      # @param created_to [Time] Query param: End date for filtering by creation date.
       #
       # @param customer_id [String] Query param: Filter paykeys by related customer ID.
       #
@@ -56,6 +60,8 @@ module Straddle
       def list(params = {})
         query_params =
           [
+            :created_from,
+            :created_to,
             :customer_id,
             :page_number,
             :page_size,

data/lib/straddle/resources/payments.rb

@@ -11,7 +11,7 @@ module Straddle
       # Search for payments, including `charges` and `payouts`, using a variety of
       # criteria. This endpoint supports advanced sorting and filtering options.
       #
-      # @overload list(customer_id: nil, default_page_size: nil, default_sort: nil, default_sort_order: nil, external_id: nil, funding_id: nil, include_metadata: nil, max_amount: nil, max_created_at: nil, max_effective_at: nil, max_payment_date: nil, min_amount: nil, min_created_at: nil, min_effective_at: nil, min_payment_date: nil, page_number: nil, page_size: nil, paykey: nil, paykey_id: nil, payment_id: nil, payment_status: nil, payment_type: nil, search_text: nil, sort_by: nil, sort_order: nil, status_reason: nil, status_source: nil, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @overload list(customer_id: nil, default_page_size: nil, default_sort: nil, default_sort_order: nil, external_id: nil, funding_id: nil, has_refund: nil, has_resubmit: nil, include_metadata: nil, is_refund: nil, is_resubmit: nil, max_amount: nil, max_created_at: nil, max_effective_at: nil, max_payment_date: nil, max_updated_at: nil, min_amount: nil, min_created_at: nil, min_effective_at: nil, min_payment_date: nil, min_updated_at: nil, page_number: nil, page_size: nil, paykey: nil, paykey_id: nil, payment_id: nil, payment_status: nil, payment_type: nil, search_text: nil, sort_by: nil, sort_order: nil, status_reason: nil, status_source: nil, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #
       # @param customer_id [String] Query param: Search using the `customer_id` of a `charge` or `payout`.
       #
@@ -25,8 +25,16 @@ module Straddle
       #
       # @param funding_id [String] Query param: Search using the `funding_id` of a `charge` or `payout`.
       #
+      # @param has_refund [Boolean] Query param: Has the payment been refunded by an associated payout (only applica
+      #
+      # @param has_resubmit [Boolean] Query param: Has the payment been resubmitted.
+      #
       # @param include_metadata [Boolean] Query param: Include the metadata for payments in the returned data.
       #
+      # @param is_refund [Boolean] Query param: Is the payment a refund of an original charge (only applicable to p
+      #
+      # @param is_resubmit [Boolean] Query param: Is the payment a resubmit of an original payment.
+      #
       # @param max_amount [Integer] Query param: Search using a maximum `amount` of a `charge` or `payout`.
       #
       # @param max_created_at [Time] Query param: Search using the latest `created_at` date of a `charge` or `payout`
@@ -35,6 +43,8 @@ module Straddle
       #
       # @param max_payment_date [Date] Query param: Search using the latest `payment_date` of a `charge` or `payout`.
       #
+      # @param max_updated_at [Time] Query param: Filter to payments last updated on or before this timestamp.
+      #
       # @param min_amount [Integer] Query param: Search using the minimum `amount of a `charge`or`payout`.
       #
       # @param min_created_at [Time] Query param: Search using the earliest `created_at` date of a `charge` or `payou
@@ -43,6 +53,8 @@ module Straddle
       #
       # @param min_payment_date [Date] Query param: Search using the earliest ` `of a `charge` or `payout`.
       #
+      # @param min_updated_at [Time] Query param: Filter to payments last updated on or after this timestamp.
+      #
       # @param page_number [Integer] Query param: Results page number. Starts at page 1.
       #
       # @param page_size [Integer] Query param: Results page size. Max value: 1000
@@ -87,15 +99,21 @@ module Straddle
             :default_sort_order,
             :external_id,
             :funding_id,
+            :has_refund,
+            :has_resubmit,
             :include_metadata,
+            :is_refund,
+            :is_resubmit,
             :max_amount,
             :max_created_at,
             :max_effective_at,
             :max_payment_date,
+            :max_updated_at,
             :min_amount,
             :min_created_at,
             :min_effective_at,
             :min_payment_date,
+            :min_updated_at,
             :page_number,
             :page_size,
             :paykey,

data/lib/straddle/resources/payouts.rb

@@ -311,6 +311,55 @@ module Straddle
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Straddle::Models::PayoutUploadAuthorizationDocumentParams} for more details.
+      #
+      # Uploads a document as proof of authorization for a payout. Uploading again adds
+      # another entry to documents rather than replacing the previous one.
+      #
+      # @overload upload_authorization_document(id, file:, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      #
+      # @param id [String] Path param
+      #
+      # @param file [Pathname, StringIO, IO, String, Straddle::FilePart] Body param: The document file to upload as proof of authorization for this payou
+      #
+      # @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::PayoutV1]
+      #
+      # @see Straddle::Models::PayoutUploadAuthorizationDocumentParams
+      def upload_authorization_document(id, params)
+        parsed, options = Straddle::PayoutUploadAuthorizationDocumentParams.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: :post,
+          path: ["v1/payouts/%1$s/authorization", id],
+          headers: {
+            "content-type" => "multipart/form-data",
+            **parsed.slice(*header_params.keys)
+          }.transform_keys(
+            header_params
+          ),
+          body: parsed.except(*header_params.keys),
+          model: Straddle::PayoutV1,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [Straddle::Client]