straddle 0.4.0 → 0.5.0

data/lib/straddle/models/charge_v1.rb

@@ -103,6 +103,24 @@ module Straddle
         #   @return [Array<String>]
         required :funding_ids, Straddle::Internal::Type::ArrayOf[String]
 
+        # @!attribute has_refund
+        #   Has the charge been refunded by an associated payout.
+        #
+        #   @return [Boolean]
+        required :has_refund, Straddle::Internal::Type::Boolean
+
+        # @!attribute has_resubmit
+        #   Has the charge been resubmitted.
+        #
+        #   @return [Boolean]
+        required :has_resubmit, Straddle::Internal::Type::Boolean
+
+        # @!attribute is_resubmit
+        #   Is the charge a resubmit of an original charge.
+        #
+        #   @return [Boolean]
+        required :is_resubmit, Straddle::Internal::Type::Boolean
+
         # @!attribute paykey
         #   Value of the `paykey` used for the charge.
         #
@@ -153,6 +171,15 @@ module Straddle
         #   @return [Straddle::Models::CustomerDetailsV1, nil]
         optional :customer_details, -> { Straddle::CustomerDetailsV1 }
 
+        # @!attribute documents
+        #   Documents uploaded for this charge (e.g. proof of authorization), in the order
+        #   they were uploaded.
+        #
+        #   @return [Array<Straddle::Models::ChargeV1::Data::Document>, nil]
+        optional :documents,
+                 -> { Straddle::Internal::Type::ArrayOf[Straddle::ChargeV1::Data::Document] },
+                 nil?: true
+
         # @!attribute effective_at
         #   Timestamp of when the charge was effective in the customer's bank account,
         #   otherwise known as the date on which the customer is debited.
@@ -189,12 +216,12 @@ module Straddle
         # @!attribute related_payments
         #   Related payments.
         #
-        #   @return [Hash{Symbol=>Symbol, Straddle::Models::ChargeV1::Data::RelatedPayment}, nil]
+        #   @return [Array<Straddle::Models::ChargeV1::Data::RelatedPayment>, nil]
         optional :related_payments,
-                 -> { Straddle::Internal::Type::HashOf[enum: Straddle::ChargeV1::Data::RelatedPayment] },
+                 -> { Straddle::Internal::Type::ArrayOf[Straddle::ChargeV1::Data::RelatedPayment] },
                  nil?: true
 
-        # @!method initialize(id:, amount:, config:, consent_type:, created_at:, currency:, description:, device:, external_id:, funding_ids:, paykey:, payment_date:, status:, status_details:, status_history:, trace_ids:, updated_at:, customer_details: nil, effective_at: nil, metadata: nil, paykey_details: nil, payment_rail: nil, processed_at: nil, related_payments: nil)
+        # @!method initialize(id:, amount:, config:, consent_type:, created_at:, currency:, description:, device:, external_id:, funding_ids:, has_refund:, has_resubmit:, is_resubmit:, paykey:, payment_date:, status:, status_details:, status_history:, trace_ids:, updated_at:, customer_details: nil, documents: nil, effective_at: nil, metadata: nil, paykey_details: nil, payment_rail: nil, processed_at: nil, related_payments: nil)
         #   Some parameter documentations has been truncated, see
         #   {Straddle::Models::ChargeV1::Data} for more details.
         #
@@ -218,6 +245,12 @@ module Straddle
         #
         #   @param funding_ids [Array<String>] Funding Ids
         #
+        #   @param has_refund [Boolean] Has the charge been refunded by an associated payout.
+        #
+        #   @param has_resubmit [Boolean] Has the charge been resubmitted.
+        #
+        #   @param is_resubmit [Boolean] Is the charge a resubmit of an original charge.
+        #
         #   @param paykey [String] Value of the `paykey` used for the charge.
         #
         #   @param payment_date [Date] The desired date on which the payment should be occur. For charges, this means t
@@ -234,6 +267,8 @@ module Straddle
         #
         #   @param customer_details [Straddle::Models::CustomerDetailsV1] Information about the customer associated with the charge.
         #
+        #   @param documents [Array<Straddle::Models::ChargeV1::Data::Document>, nil] Documents uploaded for this charge (e.g. proof of authorization), in the order t
+        #
         #   @param effective_at [Time, nil] Timestamp of when the charge was effective in the customer's bank account, other
         #
         #   @param metadata [Hash{Symbol=>String}, nil] Up to 20 additional user-defined key-value pairs. Useful for storing additional
@@ -244,7 +279,7 @@ module Straddle
         #
         #   @param processed_at [Time, nil] Timestamp of when the charge was processed by Straddle and originated to the pay
         #
-        #   @param related_payments [Hash{Symbol=>Symbol, Straddle::Models::ChargeV1::Data::RelatedPayment}, nil] Related payments.
+        #   @param related_payments [Array<Straddle::Models::ChargeV1::Data::RelatedPayment>, nil] Related payments.
 
         # @see Straddle::Models::ChargeV1::Data#config
         class Config < Straddle::Internal::Type::BaseModel
@@ -314,6 +349,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>]
@@ -490,6 +527,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::ChargeV1::Data::Document::DocumentType]
+          required :document_type, enum: -> { Straddle::ChargeV1::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::ChargeV1::Data::Document::DocumentType]
+          #
+          #   @param uploaded_at [Time] The UTC timestamp when this document was uploaded.
+
+          # @see Straddle::Models::ChargeV1::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 that the charge will be processed through.
         #
         # @see Straddle::Models::ChargeV1::Data#payment_rail
@@ -502,15 +591,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::ChargeV1::Data::RelatedPayment::PaymentType]
+          required :payment_type, enum: -> { Straddle::ChargeV1::Data::RelatedPayment::PaymentType }
 
-          # @!method self.values
-          #   @return [Array<Symbol>]
+          # @!attribute relationship
+          #
+          #   @return [Symbol, Straddle::Models::ChargeV1::Data::RelatedPayment::Relationship]
+          required :relationship, enum: -> { Straddle::ChargeV1::Data::RelatedPayment::Relationship }
+
+          # @!method initialize(id:, payment_type:, relationship:)
+          #   @param id [String] The ID of the related payment.
+          #
+          #   @param payment_type [Symbol, Straddle::Models::ChargeV1::Data::RelatedPayment::PaymentType] The type of payment.
+          #
+          #   @param relationship [Symbol, Straddle::Models::ChargeV1::Data::RelatedPayment::Relationship]
+
+          # The type of payment.
+          #
+          # @see Straddle::Models::ChargeV1::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::ChargeV1::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/embed/account_list_params.rb

@@ -8,6 +8,11 @@ module Straddle
         extend Straddle::Internal::Type::RequestParameters::Converter
         include Straddle::Internal::Type::RequestParameters
 
+        # @!attribute external_id
+        #
+        #   @return [String, nil]
+        optional :external_id, String
+
         # @!attribute page_number
         #   Results page number. Starts at page 1. Default value: 1
         #
@@ -57,7 +62,9 @@ module Straddle
         #   @return [String, nil]
         optional :request_id, String
 
-        # @!method initialize(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: {})
+        # @!method initialize(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]
+        #
         #   @param page_number [Integer] Results page number. Starts at page 1. Default value: 1
         #
         #   @param page_size [Integer] Page size. Default value: 100. Max value: 1000

data/lib/straddle/models/embed/representative.rb

@@ -198,7 +198,7 @@ module Straddle
             required :control, Straddle::Internal::Type::Boolean
 
             # @!attribute owner
-            #   Whether the representative owns any percentage of of the equity interests of the
+            #   Whether the representative owns any percentage of the equity interests of the
             #   legal entity.
             #
             #   @return [Boolean]
@@ -233,7 +233,7 @@ module Straddle
             #
             #   @param control [Boolean] Whether the representative has significant responsibility to control, manage, or
             #
-            #   @param owner [Boolean] Whether the representative owns any percentage of of the equity interests of the
+            #   @param owner [Boolean] Whether the representative owns any percentage of the equity interests of the le
             #
             #   @param primary [Boolean] Whether the person is authorized as the primary representative of the account. T
             #

data/lib/straddle/models/embed/representative_create_params.rb

@@ -126,7 +126,7 @@ module Straddle
           required :control, Straddle::Internal::Type::Boolean
 
           # @!attribute owner
-          #   Whether the representative owns any percentage of of the equity interests of the
+          #   Whether the representative owns any percentage of the equity interests of the
           #   legal entity.
           #
           #   @return [Boolean]
@@ -162,7 +162,7 @@ module Straddle
           #
           #   @param control [Boolean] Whether the representative has significant responsibility to control, manage, or
           #
-          #   @param owner [Boolean] Whether the representative owns any percentage of of the equity interests of the
+          #   @param owner [Boolean] Whether the representative owns any percentage of the equity interests of the le
           #
           #   @param primary [Boolean] Whether the person is authorized as the primary representative of the account. T
           #

data/lib/straddle/models/embed/representative_paged.rb

@@ -197,7 +197,7 @@ module Straddle
             required :control, Straddle::Internal::Type::Boolean
 
             # @!attribute owner
-            #   Whether the representative owns any percentage of of the equity interests of the
+            #   Whether the representative owns any percentage of the equity interests of the
             #   legal entity.
             #
             #   @return [Boolean]
@@ -233,7 +233,7 @@ module Straddle
             #
             #   @param control [Boolean] Whether the representative has significant responsibility to control, manage, or
             #
-            #   @param owner [Boolean] Whether the representative owns any percentage of of the equity interests of the
+            #   @param owner [Boolean] Whether the representative owns any percentage of the equity interests of the le
             #
             #   @param primary [Boolean] Whether the person is authorized as the primary representative of the account. T
             #

data/lib/straddle/models/embed/representative_update_params.rb

@@ -125,7 +125,7 @@ module Straddle
           required :control, Straddle::Internal::Type::Boolean
 
           # @!attribute owner
-          #   Whether the representative owns any percentage of of the equity interests of the
+          #   Whether the representative owns any percentage of the equity interests of the
           #   legal entity.
           #
           #   @return [Boolean]
@@ -161,7 +161,7 @@ module Straddle
           #
           #   @param control [Boolean] Whether the representative has significant responsibility to control, manage, or
           #
-          #   @param owner [Boolean] Whether the representative owns any percentage of of the equity interests of the
+          #   @param owner [Boolean] Whether the representative owns any percentage of the equity interests of the le
           #
           #   @param primary [Boolean] Whether the person is authorized as the primary representative of the account. T
           #

data/lib/straddle/models/paykey_list_params.rb

@@ -7,6 +7,18 @@ module Straddle
       extend Straddle::Internal::Type::RequestParameters::Converter
       include Straddle::Internal::Type::RequestParameters
 
+      # @!attribute created_from
+      #   Start date for filtering by creation date.
+      #
+      #   @return [Time, nil]
+      optional :created_from, Time
+
+      # @!attribute created_to
+      #   End date for filtering by creation date.
+      #
+      #   @return [Time, nil]
+      optional :created_to, Time
+
       # @!attribute customer_id
       #   Filter paykeys by related customer ID.
       #
@@ -77,10 +89,14 @@ module Straddle
       #   @return [String, nil]
       optional :straddle_account_id, String
 
-      # @!method initialize(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: {})
+      # @!method initialize(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: {})
       #   Some parameter documentations has been truncated, see
       #   {Straddle::Models::PaykeyListParams} for more details.
       #
+      #   @param created_from [Time] Start date for filtering by creation date.
+      #
+      #   @param created_to [Time] End date for filtering by creation date.
+      #
       #   @param customer_id [String] Filter paykeys by related customer ID.
       #
       #   @param page_number [Integer] Page number for paginated results. Starts at 1.

data/lib/straddle/models/payment_list_params.rb

@@ -41,12 +41,37 @@ module Straddle
       #   @return [String, nil]
       optional :funding_id, String
 
+      # @!attribute has_refund
+      #   Has the payment been refunded by an associated payout (only applicable to
+      #   charges).
+      #
+      #   @return [Boolean, nil]
+      optional :has_refund, Straddle::Internal::Type::Boolean
+
+      # @!attribute has_resubmit
+      #   Has the payment been resubmitted.
+      #
+      #   @return [Boolean, nil]
+      optional :has_resubmit, Straddle::Internal::Type::Boolean
+
       # @!attribute include_metadata
       #   Include the metadata for payments in the returned data.
       #
       #   @return [Boolean, nil]
       optional :include_metadata, Straddle::Internal::Type::Boolean
 
+      # @!attribute is_refund
+      #   Is the payment a refund of an original charge (only applicable to payouts).
+      #
+      #   @return [Boolean, nil]
+      optional :is_refund, Straddle::Internal::Type::Boolean
+
+      # @!attribute is_resubmit
+      #   Is the payment a resubmit of an original payment.
+      #
+      #   @return [Boolean, nil]
+      optional :is_resubmit, Straddle::Internal::Type::Boolean
+
       # @!attribute max_amount
       #   Search using a maximum `amount` of a `charge` or `payout`.
       #
@@ -71,6 +96,12 @@ module Straddle
       #   @return [Date, nil]
       optional :max_payment_date, Date
 
+      # @!attribute max_updated_at
+      #   Filter to payments last updated on or before this timestamp.
+      #
+      #   @return [Time, nil]
+      optional :max_updated_at, Time
+
       # @!attribute min_amount
       #   Search using the minimum `amount of a `charge`or`payout`.
       #
@@ -95,6 +126,12 @@ module Straddle
       #   @return [Date, nil]
       optional :min_payment_date, Date
 
+      # @!attribute min_updated_at
+      #   Filter to payments last updated on or after this timestamp.
+      #
+      #   @return [Time, nil]
+      optional :min_updated_at, Time
+
       # @!attribute page_number
       #   Results page number. Starts at page 1.
       #
@@ -185,7 +222,10 @@ module Straddle
       #   @return [String, nil]
       optional :straddle_account_id, String
 
-      # @!method initialize(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: {})
+      # @!method initialize(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: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Straddle::Models::PaymentListParams} for more details.
+      #
       #   @param customer_id [String] Search using the `customer_id` of a `charge` or `payout`.
       #
       #   @param default_page_size [Integer]
@@ -198,8 +238,16 @@ module Straddle
       #
       #   @param funding_id [String] Search using the `funding_id` of a `charge` or `payout`.
       #
+      #   @param has_refund [Boolean] Has the payment been refunded by an associated payout (only applicable to charge
+      #
+      #   @param has_resubmit [Boolean] Has the payment been resubmitted.
+      #
       #   @param include_metadata [Boolean] Include the metadata for payments in the returned data.
       #
+      #   @param is_refund [Boolean] Is the payment a refund of an original charge (only applicable to payouts).
+      #
+      #   @param is_resubmit [Boolean] Is the payment a resubmit of an original payment.
+      #
       #   @param max_amount [Integer] Search using a maximum `amount` of a `charge` or `payout`.
       #
       #   @param max_created_at [Time] Search using the latest `created_at` date of a `charge` or `payout`.
@@ -208,6 +256,8 @@ module Straddle
       #
       #   @param max_payment_date [Date] Search using the latest `payment_date` of a `charge` or `payout`.
       #
+      #   @param max_updated_at [Time] Filter to payments last updated on or before this timestamp.
+      #
       #   @param min_amount [Integer] Search using the minimum `amount of a `charge`or`payout`.
       #
       #   @param min_created_at [Time] Search using the earliest `created_at` date of a `charge` or `payout`.
@@ -216,6 +266,8 @@ module Straddle
       #
       #   @param min_payment_date [Date] Search using the earliest ` `of a `charge` or `payout`.
       #
+      #   @param min_updated_at [Time] Filter to payments last updated on or after this timestamp.
+      #
       #   @param page_number [Integer] Results page number. Starts at page 1.
       #
       #   @param page_size [Integer] Results page size. Max value: 1000
@@ -257,6 +309,7 @@ module Straddle
         EFFECTIVE_AT = :effective_at
         ID = :id
         AMOUNT = :amount
+        UPDATED_AT = :updated_at
 
         # @!method self.values
         #   @return [Array<Symbol>]
@@ -310,6 +363,7 @@ module Straddle
         EFFECTIVE_AT = :effective_at
         ID = :id
         AMOUNT = :amount
+        UPDATED_AT = :updated_at
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/straddle/models/payment_summary_paged_v1.rb

@@ -79,6 +79,31 @@ module Straddle
         #   @return [Array<String>]
         required :funding_ids, Straddle::Internal::Type::ArrayOf[String]
 
+        # @!attribute has_refund
+        #   Has the payment been refunded by an associated payout (only applicable to
+        #   charges).
+        #
+        #   @return [Boolean]
+        required :has_refund, Straddle::Internal::Type::Boolean
+
+        # @!attribute has_resubmit
+        #   Has the payment been resubmitted.
+        #
+        #   @return [Boolean]
+        required :has_resubmit, Straddle::Internal::Type::Boolean
+
+        # @!attribute is_refund
+        #   Is the payment a refund of an original charge (only applicable to payouts).
+        #
+        #   @return [Boolean]
+        required :is_refund, Straddle::Internal::Type::Boolean
+
+        # @!attribute is_resubmit
+        #   Is the payment a resubmit of an original payment.
+        #
+        #   @return [Boolean]
+        required :is_resubmit, Straddle::Internal::Type::Boolean
+
         # @!attribute paykey
         #   Value of the `paykey` used for the `charge` or `payout`.
         #
@@ -156,7 +181,18 @@ 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:, trace_ids:, updated_at:, customer_details: nil, effective_at: nil, funding_id: nil, metadata: nil, paykey_details: nil)
+        # @!attribute related_payments
+        #   Payments related to this one (e.g. refunds, resubmissions), mapped by payment ID
+        #   to relationship type.
+        #
+        #   @return [Array<Straddle::Models::PaymentSummaryPagedV1::Data::RelatedPayment>, nil]
+        optional :related_payments,
+                 -> {
+                   Straddle::Internal::Type::ArrayOf[Straddle::PaymentSummaryPagedV1::Data::RelatedPayment]
+                 },
+                 nil?: true
+
+        # @!method initialize(id:, amount:, created_at:, currency:, description:, external_id:, funding_ids:, has_refund:, has_resubmit:, is_refund:, is_resubmit:, paykey:, payment_date:, payment_type:, status:, status_details:, trace_ids:, updated_at:, customer_details: nil, effective_at: nil, funding_id: nil, metadata: nil, paykey_details: nil, related_payments: nil)
         #   Some parameter documentations has been truncated, see
         #   {Straddle::Models::PaymentSummaryPagedV1::Data} for more details.
         #
@@ -174,6 +210,14 @@ module Straddle
         #
         #   @param funding_ids [Array<String>] Funding ids.
         #
+        #   @param has_refund [Boolean] Has the payment been refunded by an associated payout (only applicable to charge
+        #
+        #   @param has_resubmit [Boolean] Has the payment been resubmitted.
+        #
+        #   @param is_refund [Boolean] Is the payment a refund of an original charge (only applicable to payouts).
+        #
+        #   @param is_resubmit [Boolean] Is the payment a resubmit of an original payment.
+        #
         #   @param paykey [String] Value of the `paykey` used for the `charge` or `payout`.
         #
         #   @param payment_date [Date] The desired date on which the payment should be occur. For charges, this means t
@@ -197,6 +241,8 @@ module Straddle
         #   @param metadata [Hash{Symbol=>String}, nil] Metadata for payment - only included if requested.
         #
         #   @param paykey_details [Straddle::Models::PaykeyDetailsV1] Information about the paykey used for the `charge` or `payout`.
+        #
+        #   @param related_payments [Array<Straddle::Models::PaymentSummaryPagedV1::Data::RelatedPayment>, nil] Payments related to this one (e.g. refunds, resubmissions), mapped by payment ID
 
         # The type of payment. Valid values are `charge` or `payout`.
         #
@@ -230,6 +276,57 @@ module Straddle
           # @!method self.values
           #   @return [Array<Symbol>]
         end
+
+        class RelatedPayment < Straddle::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of the related payment.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute payment_type
+          #   The type of payment.
+          #
+          #   @return [Symbol, Straddle::Models::PaymentSummaryPagedV1::Data::RelatedPayment::PaymentType]
+          required :payment_type, enum: -> { Straddle::PaymentSummaryPagedV1::Data::RelatedPayment::PaymentType }
+
+          # @!attribute relationship
+          #
+          #   @return [Symbol, Straddle::Models::PaymentSummaryPagedV1::Data::RelatedPayment::Relationship]
+          required :relationship, enum: -> { Straddle::PaymentSummaryPagedV1::Data::RelatedPayment::Relationship }
+
+          # @!method initialize(id:, payment_type:, relationship:)
+          #   @param id [String] The ID of the related payment.
+          #
+          #   @param payment_type [Symbol, Straddle::Models::PaymentSummaryPagedV1::Data::RelatedPayment::PaymentType] The type of payment.
+          #
+          #   @param relationship [Symbol, Straddle::Models::PaymentSummaryPagedV1::Data::RelatedPayment::Relationship]
+
+          # The type of payment.
+          #
+          # @see Straddle::Models::PaymentSummaryPagedV1::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::PaymentSummaryPagedV1::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
 
       # @see Straddle::Models::PaymentSummaryPagedV1#meta

data/lib/straddle/models/payout_create_params.rb

@@ -158,6 +158,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>]