straddle 0.5.0 → 1.0.0

data/lib/straddle/models/payout_release_params.rb

@@ -13,43 +13,47 @@ module Straddle
       required :id, String
 
       # @!attribute reason
-      #   Details about why the payout status was updated.
+      #   Message explaining the payout status change.
       #
-      #   @return [String]
-      required :reason, String
+      #   @return [String, nil]
+      optional :reason, String, nil?: true
 
       # @!attribute correlation_id
+      #   Optional client-generated identifier for tracing a series of related requests.
       #
       #   @return [String, nil]
       optional :correlation_id, String
 
       # @!attribute idempotency_key
+      #   Optional client-generated key for an idempotent request.
       #
       #   @return [String, nil]
       optional :idempotency_key, String
 
       # @!attribute request_id
+      #   Optional client-generated identifier for tracing one request.
       #
       #   @return [String, nil]
       optional :request_id, String
 
       # @!attribute straddle_account_id
+      #   For platform requests, the embedded account UUID that sets the request scope.
       #
       #   @return [String, nil]
       optional :straddle_account_id, String
 
-      # @!method initialize(id:, reason:, 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] Details about why the payout status was updated.
+      #   @param reason [String, nil] Message explaining the payout status change.
       #
-      #   @param correlation_id [String]
+      #   @param correlation_id [String] Optional client-generated identifier for tracing a series of related requests.
       #
-      #   @param idempotency_key [String]
+      #   @param idempotency_key [String] Optional client-generated key for an idempotent request.
       #
-      #   @param request_id [String]
+      #   @param request_id [String] Optional client-generated identifier for tracing one request.
       #
-      #   @param straddle_account_id [String]
+      #   @param straddle_account_id [String] For platform requests, the embedded account UUID that sets the request scope.
       #
       #   @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/straddle/models/payout_response.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Straddle
+  module Models
+    # @see Straddle::Resources::Charges#refund
+    class PayoutResponse < Straddle::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [Straddle::Models::Payout]
+      required :data, -> { Straddle::Payout }
+
+      # @!attribute meta
+      #   Metadata for an API request.
+      #
+      #   @return [Straddle::Models::ResponseMetadata]
+      required :meta, -> { Straddle::ResponseMetadata }
+
+      # @!attribute response_type
+      #   Shape of the response envelope.
+      #
+      #   - `object` means `data` contains one JSON object.
+      #   - `array` means `data` contains an array of JSON objects.
+      #   - `error` means `error` contains the error details.
+      #   - `none` means the response contains no data.
+      #
+      #   @return [Symbol, Straddle::Models::ResponseType]
+      required :response_type, enum: -> { Straddle::ResponseType }
+
+      # @!method initialize(data:, meta:, response_type:)
+      #   Some parameter documentations has been truncated, see
+      #   {Straddle::Models::PayoutResponse} for more details.
+      #
+      #   @param data [Straddle::Models::Payout]
+      #
+      #   @param meta [Straddle::Models::ResponseMetadata] Metadata for an API request.
+      #
+      #   @param response_type [Symbol, Straddle::Models::ResponseType] Shape of the response envelope.
+    end
+  end
+end

data/lib/straddle/models/payout_resubmit_params.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module Straddle
+  module Models
+    # @see Straddle::Resources::Payouts#resubmit
+    class PayoutResubmitParams < Straddle::Internal::Type::BaseModel
+      extend Straddle::Internal::Type::RequestParameters::Converter
+      include Straddle::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute description
+      #   Description for the resubmitted payout. Defaults to the original description if
+      #   omitted.
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
+      # @!attribute external_id
+      #   Your unique identifier for the resubmitted payout. Defaults to a new value if
+      #   omitted.
+      #
+      #   @return [String, nil]
+      optional :external_id, String, nil?: true
+
+      # @!attribute payment_date
+      #   Date when Straddle submits the resubmitted payout for processing. Defaults to
+      #   today if omitted.
+      #
+      #   @return [Date, nil]
+      optional :payment_date, Date, nil?: true
+
+      # @!attribute correlation_id
+      #   Optional client-generated identifier for tracing a series of related requests.
+      #
+      #   @return [String, nil]
+      optional :correlation_id, String
+
+      # @!attribute idempotency_key
+      #   Optional client-generated key for an idempotent request.
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!attribute request_id
+      #   Optional client-generated identifier for tracing one request.
+      #
+      #   @return [String, nil]
+      optional :request_id, String
+
+      # @!attribute straddle_account_id
+      #   For platform requests, the embedded account UUID that sets the request scope.
+      #
+      #   @return [String, nil]
+      optional :straddle_account_id, String
+
+      # @!method initialize(id:, description: nil, external_id: nil, payment_date: 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::PayoutResubmitParams} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param description [String, nil] Description for the resubmitted payout. Defaults to the original description if
+      #
+      #   @param external_id [String, nil] Your unique identifier for the resubmitted payout. Defaults to a new value if om
+      #
+      #   @param payment_date [Date, nil] Date when Straddle submits the resubmitted payout for processing. Defaults to to
+      #
+      #   @param correlation_id [String] Optional client-generated identifier for tracing a series of related requests.
+      #
+      #   @param idempotency_key [String] Optional client-generated key for an idempotent request.
+      #
+      #   @param request_id [String] Optional client-generated identifier for tracing one request.
+      #
+      #   @param straddle_account_id [String] For platform requests, the embedded account UUID that sets the request scope.
+      #
+      #   @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/straddle/models/payout_retrieve_params.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Straddle
+  module Models
+    # @see Straddle::Resources::Payouts#retrieve
+    class PayoutRetrieveParams < Straddle::Internal::Type::BaseModel
+      extend Straddle::Internal::Type::RequestParameters::Converter
+      include Straddle::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute correlation_id
+      #   Optional client-generated identifier for tracing a series of related requests.
+      #
+      #   @return [String, nil]
+      optional :correlation_id, String
+
+      # @!attribute request_id
+      #   Optional client-generated identifier for tracing one request.
+      #
+      #   @return [String, nil]
+      optional :request_id, String
+
+      # @!attribute straddle_account_id
+      #   For platform requests, the embedded account UUID that sets the request scope.
+      #
+      #   @return [String, nil]
+      optional :straddle_account_id, String
+
+      # @!method initialize(id:, correlation_id: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      #   @param id [String]
+      #
+      #   @param correlation_id [String] Optional client-generated identifier for tracing a series of related requests.
+      #
+      #   @param request_id [String] Optional client-generated identifier for tracing one request.
+      #
+      #   @param straddle_account_id [String] For platform requests, the embedded account UUID that sets the request scope.
+      #
+      #   @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/straddle/models/payout_settings.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Straddle
+  module Models
+    class PayoutSettings < Straddle::Internal::Type::BaseModel
+      # @!attribute daily_amount
+      #   Daily payout amount limit in cents.
+      #
+      #   @return [Integer]
+      required :daily_amount, Integer
+
+      # @!attribute max_amount
+      #   Maximum amount in cents for one payout.
+      #
+      #   @return [Integer]
+      required :max_amount, Integer
+
+      # @!attribute monthly_amount
+      #   Monthly payout amount limit in cents.
+      #
+      #   @return [Integer]
+      required :monthly_amount, Integer
+
+      # @!attribute monthly_count
+      #   Maximum number of payouts per calendar month.
+      #
+      #   @return [Integer]
+      required :monthly_count, Integer
+
+      # @!attribute funding_time
+      #   Funding schedule applied to payouts.
+      #
+      #   @return [String, nil]
+      optional :funding_time, String, nil?: true
+
+      # @!attribute linked_bank_account_id
+      #   ID of the linked bank account used for payout settlement.
+      #
+      #   @return [String, nil]
+      optional :linked_bank_account_id, String, nil?: true
+
+      # @!method initialize(daily_amount:, max_amount:, monthly_amount:, monthly_count:, funding_time: nil, linked_bank_account_id: nil)
+      #   @param daily_amount [Integer] Daily payout amount limit in cents.
+      #
+      #   @param max_amount [Integer] Maximum amount in cents for one payout.
+      #
+      #   @param monthly_amount [Integer] Monthly payout amount limit in cents.
+      #
+      #   @param monthly_count [Integer] Maximum number of payouts per calendar month.
+      #
+      #   @param funding_time [String, nil] Funding schedule applied to payouts.
+      #
+      #   @param linked_bank_account_id [String, nil] ID of the linked bank account used for payout settlement.
+    end
+  end
+end

data/lib/straddle/models/payout_update_params.rb

@@ -13,47 +13,50 @@ module Straddle
       required :id, String
 
       # @!attribute amount
-      #   The amount of the payout in cents.
+      #   Amount in cents.
       #
       #   @return [Integer]
       required :amount, Integer
 
       # @!attribute description
-      #   An arbitrary description for the payout.
+      #   Updated description for the payout.
       #
       #   @return [String, nil]
       required :description, String, nil?: true
 
       # @!attribute payment_date
-      #   The desired date on which the payment should be occur. For payouts, this means
-      #   the date you want the funds to be sent from your bank account.
+      #   New date for Straddle to submit the payout for processing.
       #
       #   @return [Date]
       required :payment_date, Date
 
       # @!attribute metadata
-      #   Up to 20 additional user-defined key-value pairs. Useful for storing additional
-      #   information about the payout in a structured format.
+      #   Replacement metadata for the payout. Up to 20 user-defined string key-value
+      #   pairs.
       #
       #   @return [Hash{Symbol=>String}, nil]
       optional :metadata, Straddle::Internal::Type::HashOf[String], nil?: true
 
       # @!attribute correlation_id
+      #   Optional client-generated identifier for tracing a series of related requests.
       #
       #   @return [String, nil]
       optional :correlation_id, String
 
       # @!attribute idempotency_key
+      #   Optional client-generated key for an idempotent request.
       #
       #   @return [String, nil]
       optional :idempotency_key, String
 
       # @!attribute request_id
+      #   Optional client-generated identifier for tracing one request.
       #
       #   @return [String, nil]
       optional :request_id, String
 
       # @!attribute straddle_account_id
+      #   For platform requests, the embedded account UUID that sets the request scope.
       #
       #   @return [String, nil]
       optional :straddle_account_id, String
@@ -64,21 +67,21 @@ module Straddle
       #
       #   @param id [String]
       #
-      #   @param amount [Integer] The amount of the payout in cents.
+      #   @param amount [Integer] Amount in cents.
       #
-      #   @param description [String, nil] An arbitrary description for the payout.
+      #   @param description [String, nil] Updated description for the payout.
       #
-      #   @param payment_date [Date] The desired date on which the payment should be occur. For payouts, this means t
+      #   @param payment_date [Date] New date for Straddle to submit the payout for processing.
       #
-      #   @param metadata [Hash{Symbol=>String}, nil] Up to 20 additional user-defined key-value pairs. Useful for storing additional
+      #   @param metadata [Hash{Symbol=>String}, nil] Replacement metadata for the payout. Up to 20 user-defined string key-value pair
       #
-      #   @param correlation_id [String]
+      #   @param correlation_id [String] Optional client-generated identifier for tracing a series of related requests.
       #
-      #   @param idempotency_key [String]
+      #   @param idempotency_key [String] Optional client-generated key for an idempotent request.
       #
-      #   @param request_id [String]
+      #   @param request_id [String] Optional client-generated identifier for tracing one request.
       #
-      #   @param straddle_account_id [String]
+      #   @param straddle_account_id [String] For platform requests, the embedded account UUID that sets the request scope.
       #
       #   @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/straddle/models/payout_upload_authorization_proof_params.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Straddle
+  module Models
+    # @see Straddle::Resources::Payouts#upload_authorization_proof
+    class PayoutUploadAuthorizationProofParams < Straddle::Internal::Type::BaseModel
+      extend Straddle::Internal::Type::RequestParameters::Converter
+      include Straddle::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute file
+      #   The document file to upload as proof of authorization for this payout. Supported
+      #   file types are PDF (.pdf), PNG (.png), JPEG (.jpg, .jpeg), Word (.doc), and Word
+      #   (.docx), with a maximum file size of 10 MiB (10,485,760 bytes). Empty (0-byte)
+      #   files are rejected. Uploaded files are validated for matching file signatures
+      #   (magic bytes) and file extension agreement.
+      #
+      #   @return [Pathname, StringIO, IO, String, Straddle::FilePart]
+      required :file, Straddle::Internal::Type::FileInput, api_name: :File
+
+      # @!attribute correlation_id
+      #   Optional client-generated identifier for tracing a series of related requests.
+      #
+      #   @return [String, nil]
+      optional :correlation_id, String
+
+      # @!attribute idempotency_key
+      #   Optional client-generated key for an idempotent request.
+      #
+      #   @return [String, nil]
+      optional :idempotency_key, String
+
+      # @!attribute request_id
+      #   Optional client-generated identifier for tracing one request.
+      #
+      #   @return [String, nil]
+      optional :request_id, String
+
+      # @!attribute straddle_account_id
+      #   For platform requests, the embedded account UUID that sets the request scope.
+      #
+      #   @return [String, nil]
+      optional :straddle_account_id, String
+
+      # @!method initialize(id:, file:, correlation_id: nil, idempotency_key: nil, request_id: nil, straddle_account_id: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Straddle::Models::PayoutUploadAuthorizationProofParams} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param file [Pathname, StringIO, IO, String, Straddle::FilePart] The document file to upload as proof of authorization for this payout. Supported
+      #
+      #   @param correlation_id [String] Optional client-generated identifier for tracing a series of related requests.
+      #
+      #   @param idempotency_key [String] Optional client-generated key for an idempotent request.
+      #
+      #   @param request_id [String] Optional client-generated identifier for tracing one request.
+      #
+      #   @param straddle_account_id [String] For platform requests, the embedded account UUID that sets the request scope.
+      #
+      #   @param request_options [Straddle::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end