stripe 15.2.1 → 15.3.0.pre.beta.2

data/rbi/stripe/resources/treasury/outbound_transfer.rbi

@@ -1,431 +0,0 @@
-# File generated from our OpenAPI spec
-# frozen_string_literal: true
-
-# typed: true
-module Stripe
-  module Treasury
-    # Use [OutboundTransfers](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-transfers) to transfer funds from a [FinancialAccount](https://stripe.com/docs/api#financial_accounts) to a PaymentMethod belonging to the same entity. To send funds to a different party, use [OutboundPayments](https://stripe.com/docs/api#outbound_payments) instead. You can send funds over ACH rails or through a domestic wire transfer to a user's own external bank account.
-    #
-    # Simulate OutboundTransfer state changes with the `/v1/test_helpers/treasury/outbound_transfers` endpoints. These methods can only be called on test mode objects.
-    #
-    # Related guide: [Moving money with Treasury using OutboundTransfer objects](https://docs.stripe.com/docs/treasury/moving-money/financial-accounts/out-of/outbound-transfers)
-    class OutboundTransfer < APIResource
-      class DestinationPaymentMethodDetails < Stripe::StripeObject
-        class BillingDetails < Stripe::StripeObject
-          class Address < Stripe::StripeObject
-            # City, district, suburb, town, or village.
-            sig { returns(T.nilable(String)) }
-            attr_reader :city
-            # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
-            sig { returns(T.nilable(String)) }
-            attr_reader :country
-            # Address line 1 (e.g., street, PO Box, or company name).
-            sig { returns(T.nilable(String)) }
-            attr_reader :line1
-            # Address line 2 (e.g., apartment, suite, unit, or building).
-            sig { returns(T.nilable(String)) }
-            attr_reader :line2
-            # ZIP or postal code.
-            sig { returns(T.nilable(String)) }
-            attr_reader :postal_code
-            # State, county, province, or region.
-            sig { returns(T.nilable(String)) }
-            attr_reader :state
-          end
-          # Attribute for field address
-          sig { returns(Address) }
-          attr_reader :address
-          # Email address.
-          sig { returns(T.nilable(String)) }
-          attr_reader :email
-          # Full name.
-          sig { returns(T.nilable(String)) }
-          attr_reader :name
-        end
-        class FinancialAccount < Stripe::StripeObject
-          # Token of the FinancialAccount.
-          sig { returns(String) }
-          attr_reader :id
-          # The rails used to send funds.
-          sig { returns(String) }
-          attr_reader :network
-        end
-        class UsBankAccount < Stripe::StripeObject
-          # Account holder type: individual or company.
-          sig { returns(T.nilable(String)) }
-          attr_reader :account_holder_type
-          # Account type: checkings or savings. Defaults to checking if omitted.
-          sig { returns(T.nilable(String)) }
-          attr_reader :account_type
-          # Name of the bank associated with the bank account.
-          sig { returns(T.nilable(String)) }
-          attr_reader :bank_name
-          # Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same.
-          sig { returns(T.nilable(String)) }
-          attr_reader :fingerprint
-          # Last four digits of the bank account number.
-          sig { returns(T.nilable(String)) }
-          attr_reader :last4
-          # ID of the mandate used to make this payment.
-          sig { returns(T.any(String, Stripe::Mandate)) }
-          attr_reader :mandate
-          # The network rails used. See the [docs](https://stripe.com/docs/treasury/money-movement/timelines) to learn more about money movement timelines for each network type.
-          sig { returns(String) }
-          attr_reader :network
-          # Routing number of the bank account.
-          sig { returns(T.nilable(String)) }
-          attr_reader :routing_number
-        end
-        # Attribute for field billing_details
-        sig { returns(BillingDetails) }
-        attr_reader :billing_details
-        # Attribute for field financial_account
-        sig { returns(FinancialAccount) }
-        attr_reader :financial_account
-        # The type of the payment method used in the OutboundTransfer.
-        sig { returns(String) }
-        attr_reader :type
-        # Attribute for field us_bank_account
-        sig { returns(UsBankAccount) }
-        attr_reader :us_bank_account
-      end
-      class ReturnedDetails < Stripe::StripeObject
-        # Reason for the return.
-        sig { returns(String) }
-        attr_reader :code
-        # The Transaction associated with this object.
-        sig { returns(T.any(String, Stripe::Treasury::Transaction)) }
-        attr_reader :transaction
-      end
-      class StatusTransitions < Stripe::StripeObject
-        # Timestamp describing when an OutboundTransfer changed status to `canceled`
-        sig { returns(T.nilable(Integer)) }
-        attr_reader :canceled_at
-        # Timestamp describing when an OutboundTransfer changed status to `failed`
-        sig { returns(T.nilable(Integer)) }
-        attr_reader :failed_at
-        # Timestamp describing when an OutboundTransfer changed status to `posted`
-        sig { returns(T.nilable(Integer)) }
-        attr_reader :posted_at
-        # Timestamp describing when an OutboundTransfer changed status to `returned`
-        sig { returns(T.nilable(Integer)) }
-        attr_reader :returned_at
-      end
-      class TrackingDetails < Stripe::StripeObject
-        class Ach < Stripe::StripeObject
-          # ACH trace ID of the OutboundTransfer for transfers sent over the `ach` network.
-          sig { returns(String) }
-          attr_reader :trace_id
-        end
-        class UsDomesticWire < Stripe::StripeObject
-          # CHIPS System Sequence Number (SSN) of the OutboundTransfer for transfers sent over the `us_domestic_wire` network.
-          sig { returns(T.nilable(String)) }
-          attr_reader :chips
-          # IMAD of the OutboundTransfer for transfers sent over the `us_domestic_wire` network.
-          sig { returns(T.nilable(String)) }
-          attr_reader :imad
-          # OMAD of the OutboundTransfer for transfers sent over the `us_domestic_wire` network.
-          sig { returns(T.nilable(String)) }
-          attr_reader :omad
-        end
-        # Attribute for field ach
-        sig { returns(Ach) }
-        attr_reader :ach
-        # The US bank account network used to send funds.
-        sig { returns(String) }
-        attr_reader :type
-        # Attribute for field us_domestic_wire
-        sig { returns(UsDomesticWire) }
-        attr_reader :us_domestic_wire
-      end
-      # Amount (in cents) transferred.
-      sig { returns(Integer) }
-      attr_reader :amount
-      # Returns `true` if the object can be canceled, and `false` otherwise.
-      sig { returns(T::Boolean) }
-      attr_reader :cancelable
-      # Time at which the object was created. Measured in seconds since the Unix epoch.
-      sig { returns(Integer) }
-      attr_reader :created
-      # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
-      sig { returns(String) }
-      attr_reader :currency
-      # An arbitrary string attached to the object. Often useful for displaying to users.
-      sig { returns(T.nilable(String)) }
-      attr_reader :description
-      # The PaymentMethod used as the payment instrument for an OutboundTransfer.
-      sig { returns(T.nilable(String)) }
-      attr_reader :destination_payment_method
-      # Attribute for field destination_payment_method_details
-      sig { returns(DestinationPaymentMethodDetails) }
-      attr_reader :destination_payment_method_details
-      # The date when funds are expected to arrive in the destination account.
-      sig { returns(Integer) }
-      attr_reader :expected_arrival_date
-      # The FinancialAccount that funds were pulled from.
-      sig { returns(String) }
-      attr_reader :financial_account
-      # A [hosted transaction receipt](https://stripe.com/docs/treasury/moving-money/regulatory-receipts) URL that is provided when money movement is considered regulated under Stripe's money transmission licenses.
-      sig { returns(T.nilable(String)) }
-      attr_reader :hosted_regulatory_receipt_url
-      # Unique identifier for the object.
-      sig { returns(String) }
-      attr_reader :id
-      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
-      sig { returns(T::Boolean) }
-      attr_reader :livemode
-      # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
-      sig { returns(T::Hash[String, String]) }
-      attr_reader :metadata
-      # String representing the object's type. Objects of the same type share the same value.
-      sig { returns(String) }
-      attr_reader :object
-      # Details about a returned OutboundTransfer. Only set when the status is `returned`.
-      sig { returns(T.nilable(ReturnedDetails)) }
-      attr_reader :returned_details
-      # Information about the OutboundTransfer to be sent to the recipient account.
-      sig { returns(String) }
-      attr_reader :statement_descriptor
-      # Current status of the OutboundTransfer: `processing`, `failed`, `canceled`, `posted`, `returned`. An OutboundTransfer is `processing` if it has been created and is pending. The status changes to `posted` once the OutboundTransfer has been "confirmed" and funds have left the account, or to `failed` or `canceled`. If an OutboundTransfer fails to arrive at its destination, its status will change to `returned`.
-      sig { returns(String) }
-      attr_reader :status
-      # Attribute for field status_transitions
-      sig { returns(StatusTransitions) }
-      attr_reader :status_transitions
-      # Details about network-specific tracking information if available.
-      sig { returns(T.nilable(TrackingDetails)) }
-      attr_reader :tracking_details
-      # The Transaction associated with this object.
-      sig { returns(T.any(String, Stripe::Treasury::Transaction)) }
-      attr_reader :transaction
-      class ListParams < Stripe::RequestParams
-        # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :ending_before
-        # Specifies which fields in the response should be expanded.
-        sig { returns(T.nilable(T::Array[String])) }
-        attr_accessor :expand
-        # Returns objects associated with this FinancialAccount.
-        sig { returns(String) }
-        attr_accessor :financial_account
-        # A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
-        sig { returns(T.nilable(Integer)) }
-        attr_accessor :limit
-        # A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :starting_after
-        # Only return OutboundTransfers that have the given status: `processing`, `canceled`, `failed`, `posted`, or `returned`.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :status
-        sig {
-          params(ending_before: T.nilable(String), expand: T.nilable(T::Array[String]), financial_account: String, limit: T.nilable(Integer), starting_after: T.nilable(String), status: T.nilable(String)).void
-         }
-        def initialize(
-          ending_before: nil,
-          expand: nil,
-          financial_account: nil,
-          limit: nil,
-          starting_after: nil,
-          status: nil
-        ); end
-      end
-      class CreateParams < Stripe::RequestParams
-        class DestinationPaymentMethodData < Stripe::RequestParams
-          # Required if type is set to `financial_account`. The FinancialAccount ID to send funds to.
-          sig { returns(T.nilable(String)) }
-          attr_accessor :financial_account
-          # The type of the destination.
-          sig { returns(String) }
-          attr_accessor :type
-          sig { params(financial_account: T.nilable(String), type: String).void }
-          def initialize(financial_account: nil, type: nil); end
-        end
-        class DestinationPaymentMethodOptions < Stripe::RequestParams
-          class UsBankAccount < Stripe::RequestParams
-            # Specifies the network rails to be used. If not set, will default to the PaymentMethod's preferred network. See the [docs](https://stripe.com/docs/treasury/money-movement/timelines) to learn more about money movement timelines for each network type.
-            sig { returns(T.nilable(String)) }
-            attr_accessor :network
-            sig { params(network: T.nilable(String)).void }
-            def initialize(network: nil); end
-          end
-          # Optional fields for `us_bank_account`.
-          sig {
-            returns(T.nilable(T.nilable(T.any(String, ::Stripe::Treasury::OutboundTransfer::CreateParams::DestinationPaymentMethodOptions::UsBankAccount))))
-           }
-          attr_accessor :us_bank_account
-          sig {
-            params(us_bank_account: T.nilable(T.nilable(T.any(String, ::Stripe::Treasury::OutboundTransfer::CreateParams::DestinationPaymentMethodOptions::UsBankAccount)))).void
-           }
-          def initialize(us_bank_account: nil); end
-        end
-        # Amount (in cents) to be transferred.
-        sig { returns(Integer) }
-        attr_accessor :amount
-        # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
-        sig { returns(String) }
-        attr_accessor :currency
-        # An arbitrary string attached to the object. Often useful for displaying to users.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :description
-        # The PaymentMethod to use as the payment instrument for the OutboundTransfer.
-        sig { returns(T.nilable(String)) }
-        attr_accessor :destination_payment_method
-        # Hash used to generate the PaymentMethod to be used for this OutboundTransfer. Exclusive with `destination_payment_method`.
-        sig {
-          returns(T.nilable(::Stripe::Treasury::OutboundTransfer::CreateParams::DestinationPaymentMethodData))
-         }
-        attr_accessor :destination_payment_method_data
-        # Hash describing payment method configuration details.
-        sig {
-          returns(T.nilable(::Stripe::Treasury::OutboundTransfer::CreateParams::DestinationPaymentMethodOptions))
-         }
-        attr_accessor :destination_payment_method_options
-        # Specifies which fields in the response should be expanded.
-        sig { returns(T.nilable(T::Array[String])) }
-        attr_accessor :expand
-        # The FinancialAccount to pull funds from.
-        sig { returns(String) }
-        attr_accessor :financial_account
-        # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
-        sig { returns(T.nilable(T::Hash[String, String])) }
-        attr_accessor :metadata
-        # Statement descriptor to be shown on the receiving end of an OutboundTransfer. Maximum 10 characters for `ach` transfers or 140 characters for `us_domestic_wire` transfers. The default value is "transfer".
-        sig { returns(T.nilable(String)) }
-        attr_accessor :statement_descriptor
-        sig {
-          params(amount: Integer, currency: String, description: T.nilable(String), destination_payment_method: T.nilable(String), destination_payment_method_data: T.nilable(::Stripe::Treasury::OutboundTransfer::CreateParams::DestinationPaymentMethodData), destination_payment_method_options: T.nilable(::Stripe::Treasury::OutboundTransfer::CreateParams::DestinationPaymentMethodOptions), expand: T.nilable(T::Array[String]), financial_account: String, metadata: T.nilable(T::Hash[String, String]), statement_descriptor: T.nilable(String)).void
-         }
-        def initialize(
-          amount: nil,
-          currency: nil,
-          description: nil,
-          destination_payment_method: nil,
-          destination_payment_method_data: nil,
-          destination_payment_method_options: nil,
-          expand: nil,
-          financial_account: nil,
-          metadata: nil,
-          statement_descriptor: nil
-        ); end
-      end
-      class CancelParams < Stripe::RequestParams
-        # Specifies which fields in the response should be expanded.
-        sig { returns(T.nilable(T::Array[String])) }
-        attr_accessor :expand
-        sig { params(expand: T.nilable(T::Array[String])).void }
-        def initialize(expand: nil); end
-      end
-      class UpdateParams < Stripe::RequestParams
-        class TrackingDetails < Stripe::RequestParams
-          class Ach < Stripe::RequestParams
-            # ACH trace ID for funds sent over the `ach` network.
-            sig { returns(String) }
-            attr_accessor :trace_id
-            sig { params(trace_id: String).void }
-            def initialize(trace_id: nil); end
-          end
-          class UsDomesticWire < Stripe::RequestParams
-            # CHIPS System Sequence Number (SSN) for funds sent over the `us_domestic_wire` network.
-            sig { returns(T.nilable(String)) }
-            attr_accessor :chips
-            # IMAD for funds sent over the `us_domestic_wire` network.
-            sig { returns(T.nilable(String)) }
-            attr_accessor :imad
-            # OMAD for funds sent over the `us_domestic_wire` network.
-            sig { returns(T.nilable(String)) }
-            attr_accessor :omad
-            sig {
-              params(chips: T.nilable(String), imad: T.nilable(String), omad: T.nilable(String)).void
-             }
-            def initialize(chips: nil, imad: nil, omad: nil); end
-          end
-          # ACH network tracking details.
-          sig {
-            returns(T.nilable(::Stripe::Treasury::OutboundTransfer::UpdateParams::TrackingDetails::Ach))
-           }
-          attr_accessor :ach
-          # The US bank account network used to send funds.
-          sig { returns(String) }
-          attr_accessor :type
-          # US domestic wire network tracking details.
-          sig {
-            returns(T.nilable(::Stripe::Treasury::OutboundTransfer::UpdateParams::TrackingDetails::UsDomesticWire))
-           }
-          attr_accessor :us_domestic_wire
-          sig {
-            params(ach: T.nilable(::Stripe::Treasury::OutboundTransfer::UpdateParams::TrackingDetails::Ach), type: String, us_domestic_wire: T.nilable(::Stripe::Treasury::OutboundTransfer::UpdateParams::TrackingDetails::UsDomesticWire)).void
-           }
-          def initialize(ach: nil, type: nil, us_domestic_wire: nil); end
-        end
-        # Specifies which fields in the response should be expanded.
-        sig { returns(T.nilable(T::Array[String])) }
-        attr_accessor :expand
-        # Details about network-specific tracking information.
-        sig { returns(::Stripe::Treasury::OutboundTransfer::UpdateParams::TrackingDetails) }
-        attr_accessor :tracking_details
-        sig {
-          params(expand: T.nilable(T::Array[String]), tracking_details: ::Stripe::Treasury::OutboundTransfer::UpdateParams::TrackingDetails).void
-         }
-        def initialize(expand: nil, tracking_details: nil); end
-      end
-      class FailParams < Stripe::RequestParams
-        # Specifies which fields in the response should be expanded.
-        sig { returns(T.nilable(T::Array[String])) }
-        attr_accessor :expand
-        sig { params(expand: T.nilable(T::Array[String])).void }
-        def initialize(expand: nil); end
-      end
-      class PostParams < Stripe::RequestParams
-        # Specifies which fields in the response should be expanded.
-        sig { returns(T.nilable(T::Array[String])) }
-        attr_accessor :expand
-        sig { params(expand: T.nilable(T::Array[String])).void }
-        def initialize(expand: nil); end
-      end
-      class ReturnOutboundTransferParams < Stripe::RequestParams
-        class ReturnedDetails < Stripe::RequestParams
-          # Reason for the return.
-          sig { returns(T.nilable(String)) }
-          attr_accessor :code
-          sig { params(code: T.nilable(String)).void }
-          def initialize(code: nil); end
-        end
-        # Specifies which fields in the response should be expanded.
-        sig { returns(T.nilable(T::Array[String])) }
-        attr_accessor :expand
-        # Details about a returned OutboundTransfer.
-        sig {
-          returns(T.nilable(::Stripe::Treasury::OutboundTransfer::ReturnOutboundTransferParams::ReturnedDetails))
-         }
-        attr_accessor :returned_details
-        sig {
-          params(expand: T.nilable(T::Array[String]), returned_details: T.nilable(::Stripe::Treasury::OutboundTransfer::ReturnOutboundTransferParams::ReturnedDetails)).void
-         }
-        def initialize(expand: nil, returned_details: nil); end
-      end
-      # An OutboundTransfer can be canceled if the funds have not yet been paid out.
-      sig {
-        params(params: T.any(::Stripe::Treasury::OutboundTransfer::CancelParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Treasury::OutboundTransfer)
-       }
-      def cancel(params = {}, opts = {}); end
-
-      # An OutboundTransfer can be canceled if the funds have not yet been paid out.
-      sig {
-        params(outbound_transfer: String, params: T.any(::Stripe::Treasury::OutboundTransfer::CancelParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Treasury::OutboundTransfer)
-       }
-      def self.cancel(outbound_transfer, params = {}, opts = {}); end
-
-      # Creates an OutboundTransfer.
-      sig {
-        params(params: T.any(::Stripe::Treasury::OutboundTransfer::CreateParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::Treasury::OutboundTransfer)
-       }
-      def self.create(params = {}, opts = {}); end
-
-      # Returns a list of OutboundTransfers sent from the specified FinancialAccount.
-      sig {
-        params(params: T.any(::Stripe::Treasury::OutboundTransfer::ListParams, T::Hash[T.untyped, T.untyped]), opts: T.untyped).returns(Stripe::ListObject)
-       }
-      def self.list(params = {}, opts = {}); end
-    end
-  end
-end