straddle 0.3.0 → 0.5.0

data/rbi/straddle/models/charge_v1.rbi

@@ -100,7 +100,7 @@ module Straddle
         attr_accessor :currency
 
         # An arbitrary description for the charge.
-        sig { returns(String) }
+        sig { returns(T.nilable(String)) }
         attr_accessor :description
 
         # Information about the device used when the customer authorized the payment.
@@ -119,6 +119,18 @@ module Straddle
         sig { returns(T::Array[String]) }
         attr_accessor :funding_ids
 
+        # Has the charge been refunded by an associated payout.
+        sig { returns(T::Boolean) }
+        attr_accessor :has_refund
+
+        # Has the charge been resubmitted.
+        sig { returns(T::Boolean) }
+        attr_accessor :has_resubmit
+
+        # Is the charge a resubmit of an original charge.
+        sig { returns(T::Boolean) }
+        attr_accessor :is_resubmit
+
         # Value of the `paykey` used for the charge.
         sig { returns(String) }
         attr_accessor :paykey
@@ -143,6 +155,10 @@ module Straddle
         sig { returns(T::Array[Straddle::ChargeV1::Data::StatusHistory]) }
         attr_accessor :status_history
 
+        # Trace Ids.
+        sig { returns(T::Hash[Symbol, String]) }
+        attr_accessor :trace_ids
+
         # Timestamp of when the charge was last updated.
         sig { returns(T.nilable(Time)) }
         attr_accessor :updated_at
@@ -156,6 +172,11 @@ module Straddle
         end
         attr_writer :customer_details
 
+        # Documents uploaded for this charge (e.g. proof of authorization), in the order
+        # they were uploaded.
+        sig { returns(T.nilable(T::Array[Straddle::ChargeV1::Data::Document])) }
+        attr_accessor :documents
+
         # Timestamp of when the charge was effective in the customer's bank account,
         # otherwise known as the date on which the customer is debited.
         sig { returns(T.nilable(Time)) }
@@ -193,6 +214,12 @@ module Straddle
         sig { returns(T.nilable(Time)) }
         attr_accessor :processed_at
 
+        # Related payments.
+        sig do
+          returns(T.nilable(T::Array[Straddle::ChargeV1::Data::RelatedPayment]))
+        end
+        attr_accessor :related_payments
+
         sig do
           params(
             id: String,
@@ -201,23 +228,33 @@ module Straddle
             consent_type: Straddle::ChargeV1::Data::ConsentType::OrSymbol,
             created_at: T.nilable(Time),
             currency: String,
-            description: String,
+            description: T.nilable(String),
             device: Straddle::DeviceInfoV1::OrHash,
             external_id: String,
             funding_ids: T::Array[String],
+            has_refund: T::Boolean,
+            has_resubmit: T::Boolean,
+            is_resubmit: T::Boolean,
             paykey: String,
             payment_date: Date,
             status: Straddle::ChargeV1::Data::Status::OrSymbol,
             status_details: Straddle::StatusDetailsV1::OrHash,
             status_history:
               T::Array[Straddle::ChargeV1::Data::StatusHistory::OrHash],
+            trace_ids: T::Hash[Symbol, String],
             updated_at: T.nilable(Time),
             customer_details: Straddle::CustomerDetailsV1::OrHash,
+            documents:
+              T.nilable(T::Array[Straddle::ChargeV1::Data::Document::OrHash]),
             effective_at: T.nilable(Time),
             metadata: T.nilable(T::Hash[Symbol, String]),
             paykey_details: Straddle::PaykeyDetailsV1::OrHash,
             payment_rail: Straddle::ChargeV1::Data::PaymentRail::OrSymbol,
-            processed_at: T.nilable(Time)
+            processed_at: T.nilable(Time),
+            related_payments:
+              T.nilable(
+                T::Array[Straddle::ChargeV1::Data::RelatedPayment::OrHash]
+              )
           ).returns(T.attached_class)
         end
         def self.new(
@@ -245,6 +282,12 @@ module Straddle
           external_id:,
           # Funding Ids
           funding_ids:,
+          # Has the charge been refunded by an associated payout.
+          has_refund:,
+          # Has the charge been resubmitted.
+          has_resubmit:,
+          # Is the charge a resubmit of an original charge.
+          is_resubmit:,
           # Value of the `paykey` used for the charge.
           paykey:,
           # The desired date on which the payment should be occur. For charges, this means
@@ -256,10 +299,15 @@ module Straddle
           status_details:,
           # Status history.
           status_history:,
+          # Trace Ids.
+          trace_ids:,
           # Timestamp of when the charge was last updated.
           updated_at:,
           # Information about the customer associated with the charge.
           customer_details: nil,
+          # Documents uploaded for this charge (e.g. proof of authorization), in the order
+          # they were uploaded.
+          documents: nil,
           # Timestamp of when the charge was effective in the customer's bank account,
           # otherwise known as the date on which the customer is debited.
           effective_at: nil,
@@ -272,7 +320,9 @@ module Straddle
           payment_rail: nil,
           # Timestamp of when the charge was processed by Straddle and originated to the
           # payment rail.
-          processed_at: nil
+          processed_at: nil,
+          # Related payments.
+          related_payments: nil
         )
         end
 
@@ -285,22 +335,30 @@ module Straddle
               consent_type: Straddle::ChargeV1::Data::ConsentType::TaggedSymbol,
               created_at: T.nilable(Time),
               currency: String,
-              description: String,
+              description: T.nilable(String),
               device: Straddle::DeviceInfoV1,
               external_id: String,
               funding_ids: T::Array[String],
+              has_refund: T::Boolean,
+              has_resubmit: T::Boolean,
+              is_resubmit: T::Boolean,
               paykey: String,
               payment_date: Date,
               status: Straddle::ChargeV1::Data::Status::TaggedSymbol,
               status_details: Straddle::StatusDetailsV1,
               status_history: T::Array[Straddle::ChargeV1::Data::StatusHistory],
+              trace_ids: T::Hash[Symbol, String],
               updated_at: T.nilable(Time),
               customer_details: Straddle::CustomerDetailsV1,
+              documents:
+                T.nilable(T::Array[Straddle::ChargeV1::Data::Document]),
               effective_at: T.nilable(Time),
               metadata: T.nilable(T::Hash[Symbol, String]),
               paykey_details: Straddle::PaykeyDetailsV1,
               payment_rail: Straddle::ChargeV1::Data::PaymentRail::TaggedSymbol,
-              processed_at: T.nilable(Time)
+              processed_at: T.nilable(Time),
+              related_payments:
+                T.nilable(T::Array[Straddle::ChargeV1::Data::RelatedPayment])
             }
           )
         end
@@ -324,6 +382,14 @@ module Straddle
           end
           attr_accessor :balance_check
 
+          # 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 charge 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(
@@ -347,6 +413,8 @@ module Straddle
             params(
               balance_check:
                 Straddle::ChargeV1::Data::Config::BalanceCheck::OrSymbol,
+              auto_hold: T.nilable(T::Boolean),
+              auto_hold_message: T.nilable(String),
               sandbox_outcome:
                 Straddle::ChargeV1::Data::Config::SandboxOutcome::OrSymbol
             ).returns(T.attached_class)
@@ -354,6 +422,10 @@ module Straddle
           def self.new(
             # Defines whether to check the customer's balance before processing the charge.
             balance_check:,
+            # Defines whether to automatically place this charge on hold after being created.
+            auto_hold: nil,
+            # The reason the charge is being automatically held on creation.
+            auto_hold_message: nil,
             # Payment will simulate processing if not Standard.
             sandbox_outcome: nil
           )
@@ -364,6 +436,8 @@ module Straddle
               {
                 balance_check:
                   Straddle::ChargeV1::Data::Config::BalanceCheck::TaggedSymbol,
+                auto_hold: T.nilable(T::Boolean),
+                auto_hold_message: T.nilable(String),
                 sandbox_outcome:
                   Straddle::ChargeV1::Data::Config::SandboxOutcome::TaggedSymbol
               }
@@ -474,6 +548,16 @@ module Straddle
                 :reversed_closed_bank_account,
                 Straddle::ChargeV1::Data::Config::SandboxOutcome::TaggedSymbol
               )
+            FAILED_NOT_AUTHORIZED =
+              T.let(
+                :failed_not_authorized,
+                Straddle::ChargeV1::Data::Config::SandboxOutcome::TaggedSymbol
+              )
+            REVERSED_NOT_AUTHORIZED =
+              T.let(
+                :reversed_not_authorized,
+                Straddle::ChargeV1::Data::Config::SandboxOutcome::TaggedSymbol
+              )
 
             sig do
               override.returns(
@@ -540,6 +624,8 @@ module Straddle
           PAID = T.let(:paid, Straddle::ChargeV1::Data::Status::TaggedSymbol)
           REVERSED =
             T.let(:reversed, Straddle::ChargeV1::Data::Status::TaggedSymbol)
+          VALIDATING =
+            T.let(:validating, Straddle::ChargeV1::Data::Status::TaggedSymbol)
 
           sig do
             override.returns(
@@ -755,6 +841,41 @@ module Straddle
                 :payout_refused,
                 Straddle::ChargeV1::Data::StatusHistory::Reason::TaggedSymbol
               )
+            CANCEL_REQUEST =
+              T.let(
+                :cancel_request,
+                Straddle::ChargeV1::Data::StatusHistory::Reason::TaggedSymbol
+              )
+            FAILED_VERIFICATION =
+              T.let(
+                :failed_verification,
+                Straddle::ChargeV1::Data::StatusHistory::Reason::TaggedSymbol
+              )
+            REQUIRE_REVIEW =
+              T.let(
+                :require_review,
+                Straddle::ChargeV1::Data::StatusHistory::Reason::TaggedSymbol
+              )
+            BLOCKED_BY_SYSTEM =
+              T.let(
+                :blocked_by_system,
+                Straddle::ChargeV1::Data::StatusHistory::Reason::TaggedSymbol
+              )
+            WATCHTOWER_REVIEW =
+              T.let(
+                :watchtower_review,
+                Straddle::ChargeV1::Data::StatusHistory::Reason::TaggedSymbol
+              )
+            VALIDATING =
+              T.let(
+                :validating,
+                Straddle::ChargeV1::Data::StatusHistory::Reason::TaggedSymbol
+              )
+            AUTO_HOLD =
+              T.let(
+                :auto_hold,
+                Straddle::ChargeV1::Data::StatusHistory::Reason::TaggedSymbol
+              )
 
             sig do
               override.returns(
@@ -865,6 +986,11 @@ module Straddle
                 :reversed,
                 Straddle::ChargeV1::Data::StatusHistory::Status::TaggedSymbol
               )
+            VALIDATING =
+              T.let(
+                :validating,
+                Straddle::ChargeV1::Data::StatusHistory::Status::TaggedSymbol
+              )
 
             sig do
               override.returns(
@@ -878,6 +1004,103 @@ module Straddle
           end
         end
 
+        class Document < Straddle::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Straddle::ChargeV1::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::ChargeV1::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::ChargeV1::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::ChargeV1::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::ChargeV1::Data::Document::DocumentType)
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            PAYMENT_AUTHORIZATION =
+              T.let(
+                :payment_authorization,
+                Straddle::ChargeV1::Data::Document::DocumentType::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Straddle::ChargeV1::Data::Document::DocumentType::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
         # The payment rail that the charge will be processed through.
         module PaymentRail
           extend Straddle::Internal::Type::Enum
@@ -898,6 +1121,141 @@ module Straddle
           def self.values
           end
         end
+
+        class RelatedPayment < Straddle::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Straddle::ChargeV1::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::ChargeV1::Data::RelatedPayment::PaymentType::TaggedSymbol
+            )
+          end
+          attr_accessor :payment_type
+
+          sig do
+            returns(
+              Straddle::ChargeV1::Data::RelatedPayment::Relationship::TaggedSymbol
+            )
+          end
+          attr_accessor :relationship
+
+          sig do
+            params(
+              id: String,
+              payment_type:
+                Straddle::ChargeV1::Data::RelatedPayment::PaymentType::OrSymbol,
+              relationship:
+                Straddle::ChargeV1::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::ChargeV1::Data::RelatedPayment::PaymentType::TaggedSymbol,
+                relationship:
+                  Straddle::ChargeV1::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::ChargeV1::Data::RelatedPayment::PaymentType
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            CHARGE =
+              T.let(
+                :charge,
+                Straddle::ChargeV1::Data::RelatedPayment::PaymentType::TaggedSymbol
+              )
+            PAYOUT =
+              T.let(
+                :payout,
+                Straddle::ChargeV1::Data::RelatedPayment::PaymentType::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Straddle::ChargeV1::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::ChargeV1::Data::RelatedPayment::Relationship
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            ORIGINAL =
+              T.let(
+                :original,
+                Straddle::ChargeV1::Data::RelatedPayment::Relationship::TaggedSymbol
+              )
+            RESUBMIT =
+              T.let(
+                :resubmit,
+                Straddle::ChargeV1::Data::RelatedPayment::Relationship::TaggedSymbol
+              )
+            REFUND =
+              T.let(
+                :refund,
+                Straddle::ChargeV1::Data::RelatedPayment::Relationship::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Straddle::ChargeV1::Data::RelatedPayment::Relationship::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
       end
 
       # Indicates the structure of the returned content.

data/rbi/straddle/models/customer_delete_params.rbi

@@ -11,6 +11,9 @@ module Straddle
           T.any(Straddle::CustomerDeleteParams, Straddle::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :id
+
       sig { returns(T.nilable(String)) }
       attr_reader :correlation_id
 
@@ -37,6 +40,7 @@ module Straddle
 
       sig do
         params(
+          id: String,
           correlation_id: String,
           idempotency_key: String,
           request_id: String,
@@ -45,6 +49,7 @@ module Straddle
         ).returns(T.attached_class)
       end
       def self.new(
+        id:,
         correlation_id: nil,
         idempotency_key: nil,
         request_id: nil,
@@ -56,6 +61,7 @@ module Straddle
       sig do
         override.returns(
           {
+            id: String,
             correlation_id: String,
             idempotency_key: String,
             request_id: String,

data/rbi/straddle/models/customer_get_params.rbi

@@ -11,6 +11,9 @@ module Straddle
           T.any(Straddle::CustomerGetParams, 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/customer_unmasked_params.rbi

@@ -11,6 +11,9 @@ module Straddle
           T.any(Straddle::CustomerUnmaskedParams, 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/customer_update_params.rbi

@@ -11,6 +11,9 @@ module Straddle
           T.any(Straddle::CustomerUpdateParams, Straddle::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :id
+
       sig { returns(Straddle::DeviceUnmaskedV1) }
       attr_reader :device
 
@@ -91,6 +94,7 @@ module Straddle
 
       sig do
         params(
+          id: String,
           device: Straddle::DeviceUnmaskedV1::OrHash,
           email: String,
           name: String,
@@ -114,6 +118,7 @@ module Straddle
         ).returns(T.attached_class)
       end
       def self.new(
+        id:,
         device:,
         # The customer's email address.
         email:,
@@ -144,6 +149,7 @@ module Straddle
       sig do
         override.returns(
           {
+            id: String,
             device: Straddle::DeviceUnmaskedV1,
             email: String,
             name: String,

data/rbi/straddle/models/customers/review_decision_params.rbi

@@ -15,6 +15,9 @@ module Straddle
             )
           end
 
+        sig { returns(String) }
+        attr_accessor :id
+
         # The final status of the customer review.
         sig do
           returns(Straddle::Customers::ReviewDecisionParams::Status::OrSymbol)
@@ -47,6 +50,7 @@ module Straddle
 
         sig do
           params(
+            id: String,
             status: Straddle::Customers::ReviewDecisionParams::Status::OrSymbol,
             correlation_id: String,
             idempotency_key: String,
@@ -56,6 +60,7 @@ module Straddle
           ).returns(T.attached_class)
         end
         def self.new(
+          id:,
           # The final status of the customer review.
           status:,
           correlation_id: nil,
@@ -69,6 +74,7 @@ module Straddle
         sig do
           override.returns(
             {
+              id: String,
               status:
                 Straddle::Customers::ReviewDecisionParams::Status::OrSymbol,
               correlation_id: String,