straddle 0.3.0 → 0.5.0

data/rbi/straddle/models/payout_release_params.rbi

@@ -11,6 +11,9 @@ module Straddle
           T.any(Straddle::PayoutReleaseParams, Straddle::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :id
+
       # Details about why the payout status was updated.
       sig { returns(String) }
       attr_accessor :reason
@@ -41,6 +44,7 @@ module Straddle
 
       sig do
         params(
+          id: String,
           reason: String,
           correlation_id: String,
           idempotency_key: String,
@@ -50,6 +54,7 @@ module Straddle
         ).returns(T.attached_class)
       end
       def self.new(
+        id:,
         # Details about why the payout status was updated.
         reason:,
         correlation_id: nil,
@@ -63,6 +68,7 @@ module Straddle
       sig do
         override.returns(
           {
+            id: String,
             reason: String,
             correlation_id: String,
             idempotency_key: String,

data/rbi/straddle/models/payout_unmask_params.rbi

@@ -11,6 +11,9 @@ module Straddle
           T.any(Straddle::PayoutUnmaskParams, Straddle::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :id
+
       sig { returns(T.nilable(String)) }
       attr_reader :correlation_id
 
@@ -31,6 +34,7 @@ module Straddle
 
       sig do
         params(
+          id: String,
           correlation_id: String,
           request_id: String,
           straddle_account_id: String,
@@ -38,6 +42,7 @@ module Straddle
         ).returns(T.attached_class)
       end
       def self.new(
+        id:,
         correlation_id: nil,
         request_id: nil,
         straddle_account_id: nil,
@@ -48,6 +53,7 @@ module Straddle
       sig do
         override.returns(
           {
+            id: String,
             correlation_id: String,
             request_id: String,
             straddle_account_id: String,

data/rbi/straddle/models/payout_unmask_response.rbi

@@ -108,7 +108,7 @@ module Straddle
         attr_accessor :currency
 
         # Description.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :description
 
         sig { returns(Straddle::Models::PayoutUnmaskResponse::Data::Device) }
@@ -129,6 +129,18 @@ module Straddle
         sig { returns(T::Array[String]) }
         attr_accessor :funding_ids
 
+        # Has the payout been resubmitted.
+        sig { returns(T::Boolean) }
+        attr_accessor :has_resubmit
+
+        # Is the payout a refund of an original charge.
+        sig { returns(T::Boolean) }
+        attr_accessor :is_refund
+
+        # Is the payout a resubmit of an original payout.
+        sig { returns(T::Boolean) }
+        attr_accessor :is_resubmit
+
         # Paykey.
         sig { returns(String) }
         attr_accessor :paykey
@@ -161,6 +173,10 @@ module Straddle
         end
         attr_accessor :status_history
 
+        # Trace Ids.
+        sig { returns(T::Hash[Symbol, String]) }
+        attr_accessor :trace_ids
+
         # Created at.
         sig { returns(T.nilable(Time)) }
         attr_accessor :created_at
@@ -174,6 +190,17 @@ module Straddle
         end
         attr_writer :customer_details
 
+        # Documents uploaded for this payout (e.g. proof of authorization), in the order
+        # they were uploaded.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[Straddle::Models::PayoutUnmaskResponse::Data::Document]
+            )
+          )
+        end
+        attr_accessor :documents
+
         # Effective at.
         sig { returns(T.nilable(Time)) }
         attr_accessor :effective_at
@@ -210,6 +237,18 @@ module Straddle
         sig { returns(T.nilable(Time)) }
         attr_accessor :processed_at
 
+        # Related payments.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[
+                Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment
+              ]
+            )
+          )
+        end
+        attr_accessor :related_payments
+
         # Updated at.
         sig { returns(T.nilable(Time)) }
         attr_accessor :updated_at
@@ -221,11 +260,14 @@ module Straddle
             config:
               Straddle::Models::PayoutUnmaskResponse::Data::Config::OrHash,
             currency: String,
-            description: String,
+            description: T.nilable(String),
             device:
               Straddle::Models::PayoutUnmaskResponse::Data::Device::OrHash,
             external_id: String,
             funding_ids: T::Array[String],
+            has_resubmit: T::Boolean,
+            is_refund: T::Boolean,
+            is_resubmit: T::Boolean,
             paykey: String,
             payment_date: Date,
             status:
@@ -235,14 +277,27 @@ module Straddle
               T::Array[
                 Straddle::Models::PayoutUnmaskResponse::Data::StatusHistory::OrHash
               ],
+            trace_ids: T::Hash[Symbol, String],
             created_at: T.nilable(Time),
             customer_details: Straddle::CustomerDetailsV1::OrHash,
+            documents:
+              T.nilable(
+                T::Array[
+                  Straddle::Models::PayoutUnmaskResponse::Data::Document::OrHash
+                ]
+              ),
             effective_at: T.nilable(Time),
             metadata: T.nilable(T::Hash[Symbol, String]),
             paykey_details: Straddle::PaykeyDetailsV1::OrHash,
             payment_rail:
               Straddle::Models::PayoutUnmaskResponse::Data::PaymentRail::OrSymbol,
             processed_at: T.nilable(Time),
+            related_payments:
+              T.nilable(
+                T::Array[
+                  Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::OrHash
+                ]
+              ),
             updated_at: T.nilable(Time)
           ).returns(T.attached_class)
         end
@@ -261,6 +316,12 @@ module Straddle
           external_id:,
           # Funding Ids
           funding_ids:,
+          # Has the payout been resubmitted.
+          has_resubmit:,
+          # Is the payout a refund of an original charge.
+          is_refund:,
+          # Is the payout a resubmit of an original payout.
+          is_resubmit:,
           # Paykey.
           paykey:,
           # Payment date.
@@ -270,10 +331,15 @@ module Straddle
           status_details:,
           # Status history.
           status_history:,
+          # Trace Ids.
+          trace_ids:,
           # Created at.
           created_at: nil,
           # Information about the customer associated with the charge or payout.
           customer_details: nil,
+          # Documents uploaded for this payout (e.g. proof of authorization), in the order
+          # they were uploaded.
+          documents: nil,
           # Effective at.
           effective_at: nil,
           # Metadata.
@@ -283,6 +349,8 @@ module Straddle
           payment_rail: nil,
           # Processed at.
           processed_at: nil,
+          # Related payments.
+          related_payments: nil,
           # Updated at.
           updated_at: nil
         )
@@ -295,10 +363,13 @@ module Straddle
               amount: Integer,
               config: Straddle::Models::PayoutUnmaskResponse::Data::Config,
               currency: String,
-              description: String,
+              description: T.nilable(String),
               device: Straddle::Models::PayoutUnmaskResponse::Data::Device,
               external_id: String,
               funding_ids: T::Array[String],
+              has_resubmit: T::Boolean,
+              is_refund: T::Boolean,
+              is_resubmit: T::Boolean,
               paykey: String,
               payment_date: Date,
               status:
@@ -308,14 +379,27 @@ module Straddle
                 T::Array[
                   Straddle::Models::PayoutUnmaskResponse::Data::StatusHistory
                 ],
+              trace_ids: T::Hash[Symbol, String],
               created_at: T.nilable(Time),
               customer_details: Straddle::CustomerDetailsV1,
+              documents:
+                T.nilable(
+                  T::Array[
+                    Straddle::Models::PayoutUnmaskResponse::Data::Document
+                  ]
+                ),
               effective_at: T.nilable(Time),
               metadata: T.nilable(T::Hash[Symbol, String]),
               paykey_details: Straddle::PaykeyDetailsV1,
               payment_rail:
                 Straddle::Models::PayoutUnmaskResponse::Data::PaymentRail::TaggedSymbol,
               processed_at: T.nilable(Time),
+              related_payments:
+                T.nilable(
+                  T::Array[
+                    Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment
+                  ]
+                ),
               updated_at: T.nilable(Time)
             }
           )
@@ -332,6 +416,14 @@ module Straddle
               )
             end
 
+          # Defines whether to automatically place this charge on hold after being created.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_accessor :auto_hold
+
+          # The reason the payout is being automatically held on creation.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :auto_hold_message
+
           # Payment will simulate processing if not Standard.
           sig do
             returns(
@@ -352,11 +444,17 @@ module Straddle
 
           sig do
             params(
+              auto_hold: T.nilable(T::Boolean),
+              auto_hold_message: T.nilable(String),
               sandbox_outcome:
                 Straddle::Models::PayoutUnmaskResponse::Data::Config::SandboxOutcome::OrSymbol
             ).returns(T.attached_class)
           end
           def self.new(
+            # Defines whether to automatically place this charge on hold after being created.
+            auto_hold: nil,
+            # The reason the payout is being automatically held on creation.
+            auto_hold_message: nil,
             # Payment will simulate processing if not Standard.
             sandbox_outcome: nil
           )
@@ -365,6 +463,8 @@ module Straddle
           sig do
             override.returns(
               {
+                auto_hold: T.nilable(T::Boolean),
+                auto_hold_message: T.nilable(String),
                 sandbox_outcome:
                   Straddle::Models::PayoutUnmaskResponse::Data::Config::SandboxOutcome::TaggedSymbol
               }
@@ -441,6 +541,16 @@ module Straddle
                 :reversed_closed_bank_account,
                 Straddle::Models::PayoutUnmaskResponse::Data::Config::SandboxOutcome::TaggedSymbol
               )
+            FAILED_NOT_AUTHORIZED =
+              T.let(
+                :failed_not_authorized,
+                Straddle::Models::PayoutUnmaskResponse::Data::Config::SandboxOutcome::TaggedSymbol
+              )
+            REVERSED_NOT_AUTHORIZED =
+              T.let(
+                :reversed_not_authorized,
+                Straddle::Models::PayoutUnmaskResponse::Data::Config::SandboxOutcome::TaggedSymbol
+              )
 
             sig do
               override.returns(
@@ -532,6 +642,11 @@ module Straddle
               :reversed,
               Straddle::Models::PayoutUnmaskResponse::Data::Status::TaggedSymbol
             )
+          VALIDATING =
+            T.let(
+              :validating,
+              Straddle::Models::PayoutUnmaskResponse::Data::Status::TaggedSymbol
+            )
 
           sig do
             override.returns(
@@ -754,6 +869,41 @@ module Straddle
                 :payout_refused,
                 Straddle::Models::PayoutUnmaskResponse::Data::StatusHistory::Reason::TaggedSymbol
               )
+            CANCEL_REQUEST =
+              T.let(
+                :cancel_request,
+                Straddle::Models::PayoutUnmaskResponse::Data::StatusHistory::Reason::TaggedSymbol
+              )
+            FAILED_VERIFICATION =
+              T.let(
+                :failed_verification,
+                Straddle::Models::PayoutUnmaskResponse::Data::StatusHistory::Reason::TaggedSymbol
+              )
+            REQUIRE_REVIEW =
+              T.let(
+                :require_review,
+                Straddle::Models::PayoutUnmaskResponse::Data::StatusHistory::Reason::TaggedSymbol
+              )
+            BLOCKED_BY_SYSTEM =
+              T.let(
+                :blocked_by_system,
+                Straddle::Models::PayoutUnmaskResponse::Data::StatusHistory::Reason::TaggedSymbol
+              )
+            WATCHTOWER_REVIEW =
+              T.let(
+                :watchtower_review,
+                Straddle::Models::PayoutUnmaskResponse::Data::StatusHistory::Reason::TaggedSymbol
+              )
+            VALIDATING =
+              T.let(
+                :validating,
+                Straddle::Models::PayoutUnmaskResponse::Data::StatusHistory::Reason::TaggedSymbol
+              )
+            AUTO_HOLD =
+              T.let(
+                :auto_hold,
+                Straddle::Models::PayoutUnmaskResponse::Data::StatusHistory::Reason::TaggedSymbol
+              )
 
             sig do
               override.returns(
@@ -870,6 +1020,11 @@ module Straddle
                 :reversed,
                 Straddle::Models::PayoutUnmaskResponse::Data::StatusHistory::Status::TaggedSymbol
               )
+            VALIDATING =
+              T.let(
+                :validating,
+                Straddle::Models::PayoutUnmaskResponse::Data::StatusHistory::Status::TaggedSymbol
+              )
 
             sig do
               override.returns(
@@ -883,6 +1038,106 @@ module Straddle
           end
         end
 
+        class Document < Straddle::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Straddle::Models::PayoutUnmaskResponse::Data::Document,
+                Straddle::Internal::AnyHash
+              )
+            end
+
+          # Unique identifier for this document.
+          sig { returns(String) }
+          attr_accessor :document_id
+
+          # The file name of this document as uploaded.
+          sig { returns(String) }
+          attr_accessor :document_name
+
+          # The size of this document in bytes.
+          sig { returns(Integer) }
+          attr_accessor :document_size
+
+          sig do
+            returns(
+              Straddle::Models::PayoutUnmaskResponse::Data::Document::DocumentType::TaggedSymbol
+            )
+          end
+          attr_accessor :document_type
+
+          # The UTC timestamp when this document was uploaded.
+          sig { returns(Time) }
+          attr_accessor :uploaded_at
+
+          sig do
+            params(
+              document_id: String,
+              document_name: String,
+              document_size: Integer,
+              document_type:
+                Straddle::Models::PayoutUnmaskResponse::Data::Document::DocumentType::OrSymbol,
+              uploaded_at: Time
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Unique identifier for this document.
+            document_id:,
+            # The file name of this document as uploaded.
+            document_name:,
+            # The size of this document in bytes.
+            document_size:,
+            document_type:,
+            # The UTC timestamp when this document was uploaded.
+            uploaded_at:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                document_id: String,
+                document_name: String,
+                document_size: Integer,
+                document_type:
+                  Straddle::Models::PayoutUnmaskResponse::Data::Document::DocumentType::TaggedSymbol,
+                uploaded_at: Time
+              }
+            )
+          end
+          def to_hash
+          end
+
+          module DocumentType
+            extend Straddle::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Straddle::Models::PayoutUnmaskResponse::Data::Document::DocumentType
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            PAYMENT_AUTHORIZATION =
+              T.let(
+                :payment_authorization,
+                Straddle::Models::PayoutUnmaskResponse::Data::Document::DocumentType::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Straddle::Models::PayoutUnmaskResponse::Data::Document::DocumentType::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
         # The payment rail used for the charge or payout.
         module PaymentRail
           extend Straddle::Internal::Type::Enum
@@ -912,6 +1167,141 @@ module Straddle
           def self.values
           end
         end
+
+        class RelatedPayment < Straddle::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment,
+                Straddle::Internal::AnyHash
+              )
+            end
+
+          # The ID of the related payment.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # The type of payment.
+          sig do
+            returns(
+              Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::PaymentType::TaggedSymbol
+            )
+          end
+          attr_accessor :payment_type
+
+          sig do
+            returns(
+              Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::Relationship::TaggedSymbol
+            )
+          end
+          attr_accessor :relationship
+
+          sig do
+            params(
+              id: String,
+              payment_type:
+                Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::PaymentType::OrSymbol,
+              relationship:
+                Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::Relationship::OrSymbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The ID of the related payment.
+            id:,
+            # The type of payment.
+            payment_type:,
+            relationship:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                payment_type:
+                  Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::PaymentType::TaggedSymbol,
+                relationship:
+                  Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::Relationship::TaggedSymbol
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # The type of payment.
+          module PaymentType
+            extend Straddle::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::PaymentType
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            CHARGE =
+              T.let(
+                :charge,
+                Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::PaymentType::TaggedSymbol
+              )
+            PAYOUT =
+              T.let(
+                :payout,
+                Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::PaymentType::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::PaymentType::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          module Relationship
+            extend Straddle::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::Relationship
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            ORIGINAL =
+              T.let(
+                :original,
+                Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::Relationship::TaggedSymbol
+              )
+            RESUBMIT =
+              T.let(
+                :resubmit,
+                Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::Relationship::TaggedSymbol
+              )
+            REFUND =
+              T.let(
+                :refund,
+                Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::Relationship::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Straddle::Models::PayoutUnmaskResponse::Data::RelatedPayment::Relationship::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
       end
 
       # Indicates the structure of the returned content.

data/rbi/straddle/models/payout_update_params.rbi

@@ -11,12 +11,15 @@ module Straddle
           T.any(Straddle::PayoutUpdateParams, Straddle::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :id
+
       # The amount of the payout in cents.
       sig { returns(Integer) }
       attr_accessor :amount
 
       # An arbitrary description for the payout.
-      sig { returns(String) }
+      sig { returns(T.nilable(String)) }
       attr_accessor :description
 
       # The desired date on which the payment should be occur. For payouts, this means
@@ -55,8 +58,9 @@ module Straddle
 
       sig do
         params(
+          id: String,
           amount: Integer,
-          description: String,
+          description: T.nilable(String),
           payment_date: Date,
           metadata: T.nilable(T::Hash[Symbol, String]),
           correlation_id: String,
@@ -67,6 +71,7 @@ module Straddle
         ).returns(T.attached_class)
       end
       def self.new(
+        id:,
         # The amount of the payout in cents.
         amount:,
         # An arbitrary description for the payout.
@@ -88,8 +93,9 @@ module Straddle
       sig do
         override.returns(
           {
+            id: String,
             amount: Integer,
-            description: String,
+            description: T.nilable(String),
             payment_date: Date,
             metadata: T.nilable(T::Hash[Symbol, String]),
             correlation_id: String,