straddle 0.3.0 → 0.5.0

data/lib/straddle/models/charge_get_params.rb

@@ -7,6 +7,11 @@ module Straddle
       extend Straddle::Internal::Type::RequestParameters::Converter
       include Straddle::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute correlation_id
       #
       #   @return [String, nil]
@@ -22,7 +27,8 @@ module Straddle
       #   @return [String, nil]
       optional :straddle_account_id, String
 
-      # @!method initialize(correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @!method initialize(id:, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      #   @param id [String]
       #   @param correlation_id [String]
       #   @param request_id [String]
       #   @param straddle_account_id [String]

data/lib/straddle/models/charge_hold_params.rb

@@ -7,6 +7,11 @@ module Straddle
       extend Straddle::Internal::Type::RequestParameters::Converter
       include Straddle::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute reason
       #   Details about why the charge status was updated.
       #
@@ -33,7 +38,9 @@ module Straddle
       #   @return [String, nil]
       optional :straddle_account_id, String
 
-      # @!method initialize(reason: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @!method initialize(id:, reason: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      #   @param id [String]
+      #
       #   @param reason [String, nil] Details about why the charge status was updated.
       #
       #   @param correlation_id [String]

data/lib/straddle/models/charge_release_params.rb

@@ -7,6 +7,11 @@ module Straddle
       extend Straddle::Internal::Type::RequestParameters::Converter
       include Straddle::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute reason
       #   Details about why the charge status was updated.
       #
@@ -33,7 +38,9 @@ module Straddle
       #   @return [String, nil]
       optional :straddle_account_id, String
 
-      # @!method initialize(reason: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @!method initialize(id:, reason: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      #   @param id [String]
+      #
       #   @param reason [String, nil] Details about why the charge status was updated.
       #
       #   @param correlation_id [String]

data/lib/straddle/models/charge_unmask_params.rb

@@ -7,6 +7,11 @@ module Straddle
       extend Straddle::Internal::Type::RequestParameters::Converter
       include Straddle::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute correlation_id
       #
       #   @return [String, nil]
@@ -22,7 +27,8 @@ module Straddle
       #   @return [String, nil]
       optional :straddle_account_id, String
 
-      # @!method initialize(correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @!method initialize(id:, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      #   @param id [String]
       #   @param correlation_id [String]
       #   @param request_id [String]
       #   @param straddle_account_id [String]

data/lib/straddle/models/charge_unmask_response.rb

@@ -80,8 +80,8 @@ module Straddle
         # @!attribute description
         #   Description.
         #
-        #   @return [String]
-        required :description, String
+        #   @return [String, nil]
+        required :description, String, nil?: true
 
         # @!attribute device
         #
@@ -100,6 +100,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
         #   Paykey.
         #
@@ -130,6 +148,12 @@ module Straddle
         required :status_history,
                  -> { Straddle::Internal::Type::ArrayOf[Straddle::Models::ChargeUnmaskResponse::Data::StatusHistory] }
 
+        # @!attribute trace_ids
+        #   Trace Ids.
+        #
+        #   @return [Hash{Symbol=>String}]
+        required :trace_ids, Straddle::Internal::Type::HashOf[String]
+
         # @!attribute updated_at
         #   Updated at.
         #
@@ -142,6 +166,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::ChargeUnmaskResponse::Data::Document>, nil]
+        optional :documents,
+                 -> { Straddle::Internal::Type::ArrayOf[Straddle::Models::ChargeUnmaskResponse::Data::Document] },
+                 nil?: true
+
         # @!attribute effective_at
         #   Effective at.
         #
@@ -171,7 +204,15 @@ module Straddle
         #   @return [Time, nil]
         optional :processed_at, Time, 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:, updated_at:, customer_details: nil, effective_at: nil, metadata: nil, paykey_details: nil, payment_rail: nil, processed_at: nil)
+        # @!attribute related_payments
+        #   Related payments.
+        #
+        #   @return [Array<Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment>, nil]
+        optional :related_payments,
+                 -> { Straddle::Internal::Type::ArrayOf[Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment] },
+                 nil?: true
+
+        # @!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::ChargeUnmaskResponse::Data} for more details.
         #
@@ -187,7 +228,7 @@ module Straddle
         #
         #   @param currency [String] Currency.
         #
-        #   @param description [String] Description.
+        #   @param description [String, nil] Description.
         #
         #   @param device [Straddle::Models::ChargeUnmaskResponse::Data::Device]
         #
@@ -195,6 +236,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] Paykey.
         #
         #   @param payment_date [Date] Payment date.
@@ -205,10 +252,14 @@ module Straddle
         #
         #   @param status_history [Array<Straddle::Models::ChargeUnmaskResponse::Data::StatusHistory>] Status history.
         #
+        #   @param trace_ids [Hash{Symbol=>String}] Trace Ids.
+        #
         #   @param updated_at [Time] Updated at.
         #
         #   @param customer_details [Straddle::Models::CustomerDetailsV1] Information about the customer associated with the charge or payout.
         #
+        #   @param documents [Array<Straddle::Models::ChargeUnmaskResponse::Data::Document>, nil] Documents uploaded for this charge (e.g. proof of authorization), in the order t
+        #
         #   @param effective_at [Time, nil] Effective at.
         #
         #   @param metadata [Hash{Symbol=>String}, nil] Metadata.
@@ -218,6 +269,8 @@ module Straddle
         #   @param payment_rail [Symbol, Straddle::Models::ChargeUnmaskResponse::Data::PaymentRail] The payment rail used for the charge or payout.
         #
         #   @param processed_at [Time, nil] Processed at.
+        #
+        #   @param related_payments [Array<Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment>, nil] Related payments.
 
         # @see Straddle::Models::ChargeUnmaskResponse::Data#config
         class Config < Straddle::Internal::Type::BaseModel
@@ -227,6 +280,18 @@ module Straddle
           #   @return [Symbol, Straddle::Models::ChargeUnmaskResponse::Data::Config::BalanceCheck]
           required :balance_check, enum: -> { Straddle::Models::ChargeUnmaskResponse::Data::Config::BalanceCheck }
 
+          # @!attribute auto_hold
+          #   Defines whether to automatically place this charge on hold after being created.
+          #
+          #   @return [Boolean, nil]
+          optional :auto_hold, Straddle::Internal::Type::Boolean, nil?: true
+
+          # @!attribute auto_hold_message
+          #   The reason the charge is being automatically held on creation.
+          #
+          #   @return [String, nil]
+          optional :auto_hold_message, String, nil?: true
+
           # @!attribute sandbox_outcome
           #   Payment will simulate processing if not Standard.
           #
@@ -234,9 +299,13 @@ module Straddle
           optional :sandbox_outcome,
                    enum: -> { Straddle::Models::ChargeUnmaskResponse::Data::Config::SandboxOutcome }
 
-          # @!method initialize(balance_check:, sandbox_outcome: nil)
+          # @!method initialize(balance_check:, auto_hold: nil, auto_hold_message: nil, sandbox_outcome: nil)
           #   @param balance_check [Symbol, Straddle::Models::ChargeUnmaskResponse::Data::Config::BalanceCheck] Defines whether to check the customer's balance before processing the charge.
           #
+          #   @param auto_hold [Boolean, nil] Defines whether to automatically place this charge on hold after being created.
+          #
+          #   @param auto_hold_message [String, nil] The reason the charge is being automatically held on creation.
+          #
           #   @param sandbox_outcome [Symbol, Straddle::Models::ChargeUnmaskResponse::Data::Config::SandboxOutcome] Payment will simulate processing if not Standard.
 
           # Defines whether to check the customer's balance before processing the charge.
@@ -270,6 +339,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>]
@@ -318,6 +389,7 @@ module Straddle
           PENDING = :pending
           PAID = :paid
           REVERSED = :reversed
+          VALIDATING = :validating
 
           # @!method self.values
           #   @return [Array<Symbol>]
@@ -405,6 +477,13 @@ module Straddle
             OK = :ok
             OTHER_NETWORK_RETURN = :other_network_return
             PAYOUT_REFUSED = :payout_refused
+            CANCEL_REQUEST = :cancel_request
+            FAILED_VERIFICATION = :failed_verification
+            REQUIRE_REVIEW = :require_review
+            BLOCKED_BY_SYSTEM = :blocked_by_system
+            WATCHTOWER_REVIEW = :watchtower_review
+            VALIDATING = :validating
+            AUTO_HOLD = :auto_hold
 
             # @!method self.values
             #   @return [Array<Symbol>]
@@ -441,6 +520,59 @@ module Straddle
             PENDING = :pending
             PAID = :paid
             REVERSED = :reversed
+            VALIDATING = :validating
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          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::ChargeUnmaskResponse::Data::Document::DocumentType]
+          required :document_type, enum: -> { Straddle::Models::ChargeUnmaskResponse::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::ChargeUnmaskResponse::Data::Document::DocumentType]
+          #
+          #   @param uploaded_at [Time] The UTC timestamp when this document was uploaded.
+
+          # @see Straddle::Models::ChargeUnmaskResponse::Data::Document#document_type
+          module DocumentType
+            extend Straddle::Internal::Type::Enum
+
+            PAYMENT_AUTHORIZATION = :payment_authorization
 
             # @!method self.values
             #   @return [Array<Symbol>]
@@ -458,6 +590,59 @@ 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::ChargeUnmaskResponse::Data::RelatedPayment::PaymentType]
+          required :payment_type,
+                   enum: -> { Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::PaymentType }
+
+          # @!attribute relationship
+          #
+          #   @return [Symbol, Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::Relationship]
+          required :relationship,
+                   enum: -> { Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::Relationship }
+
+          # @!method initialize(id:, payment_type:, relationship:)
+          #   @param id [String] The ID of the related payment.
+          #
+          #   @param payment_type [Symbol, Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::PaymentType] The type of payment.
+          #
+          #   @param relationship [Symbol, Straddle::Models::ChargeUnmaskResponse::Data::RelatedPayment::Relationship]
+
+          # The type of payment.
+          #
+          # @see Straddle::Models::ChargeUnmaskResponse::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::ChargeUnmaskResponse::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
 
       # Indicates the structure of the returned content.

data/lib/straddle/models/charge_update_params.rb

@@ -7,6 +7,11 @@ module Straddle
       extend Straddle::Internal::Type::RequestParameters::Converter
       include Straddle::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute amount
       #   The amount of the charge in cents.
       #
@@ -16,8 +21,8 @@ module Straddle
       # @!attribute description
       #   An arbitrary description for the charge.
       #
-      #   @return [String]
-      required :description, String
+      #   @return [String, nil]
+      required :description, String, nil?: true
 
       # @!attribute payment_date
       #   The desired date on which the payment should be occur. For charges, this means
@@ -53,13 +58,15 @@ module Straddle
       #   @return [String, nil]
       optional :straddle_account_id, String
 
-      # @!method initialize(amount:, description:, payment_date:, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      # @!method initialize(id:, amount:, description:, payment_date:, metadata: nil, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Straddle::Models::ChargeUpdateParams} for more details.
       #
+      #   @param id [String]
+      #
       #   @param amount [Integer] The amount of the charge in cents.
       #
-      #   @param description [String] An arbitrary description for the charge.
+      #   @param description [String, nil] An arbitrary description for the charge.
       #
       #   @param payment_date [Date] The desired date on which the payment should be occur. For charges, this means t
       #