stripe 15.4.0 → 15.5.0.pre.beta.1

data/lib/stripe/services/v2/money_management/payout_method_service.rb

@@ -0,0 +1,90 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module MoneyManagement
+      class PayoutMethodService < StripeService
+        class ListParams < Stripe::RequestParams
+          class UsageStatus < Stripe::RequestParams
+            # List of payments status to filter by.
+            attr_accessor :payments
+            # List of transfers status to filter by.
+            attr_accessor :transfers
+
+            def initialize(payments: nil, transfers: nil)
+              @payments = payments
+              @transfers = transfers
+            end
+          end
+          # The page size.
+          attr_accessor :limit
+          # Usage status filter.
+          attr_accessor :usage_status
+
+          def initialize(limit: nil, usage_status: nil)
+            @limit = limit
+            @usage_status = usage_status
+          end
+        end
+
+        class RetrieveParams < Stripe::RequestParams; end
+        class ArchiveParams < Stripe::RequestParams; end
+        class UnarchiveParams < Stripe::RequestParams; end
+
+        # Archive a PayoutMethod object. Archived objects cannot be used as payout methods
+        # and will not appear in the payout method list.
+        #
+        # ** raises ControlledByDashboardError
+        # ** raises InvalidPayoutMethodError
+        def archive(id, params = {}, opts = {})
+          request(
+            method: :post,
+            path: format("/v2/money_management/payout_methods/%<id>s/archive", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # List objects that adhere to the PayoutMethod interface.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/money_management/payout_methods",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieve a PayoutMethod object.
+        #
+        # ** raises InvalidPayoutMethodError
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/money_management/payout_methods/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Unarchive an PayoutMethod object.
+        #
+        # ** raises ControlledByDashboardError
+        # ** raises InvalidPayoutMethodError
+        def unarchive(id, params = {}, opts = {})
+          request(
+            method: :post,
+            path: format("/v2/money_management/payout_methods/%<id>s/unarchive", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/money_management/payout_methods_bank_account_spec_service.rb

@@ -0,0 +1,32 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module MoneyManagement
+      class PayoutMethodsBankAccountSpecService < StripeService
+        class RetrieveParams < Stripe::RequestParams
+          # The countries to fetch the bank account spec for.
+          attr_accessor :countries
+
+          def initialize(countries: nil)
+            @countries = countries
+          end
+        end
+
+        # Fetch the specifications for a set of countries to know which
+        # credential fields are required, the validations for each fields, and how to translate these
+        # country-specific fields to the generic fields in the PayoutMethodBankAccount type.
+        def retrieve(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/money_management/payout_methods_bank_account_spec",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/money_management/received_credit_service.rb

@@ -0,0 +1,70 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module MoneyManagement
+      class ReceivedCreditService < StripeService
+        class ListParams < Stripe::RequestParams
+          # Filter for objects created at the specified timestamp.
+          # Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z.
+          attr_accessor :created
+          # Filter for objects created after the specified timestamp.
+          # Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z.
+          attr_accessor :created_gt
+          # Filter for objects created on or after the specified timestamp.
+          # Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z.
+          attr_accessor :created_gte
+          # Filter for objects created before the specified timestamp.
+          # Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z.
+          attr_accessor :created_lt
+          # Filter for objects created on or before the specified timestamp.
+          # Must be an RFC 3339 date & time value, for example: 2022-09-18T13:22:00Z.
+          attr_accessor :created_lte
+          # The page limit.
+          attr_accessor :limit
+
+          def initialize(
+            created: nil,
+            created_gt: nil,
+            created_gte: nil,
+            created_lt: nil,
+            created_lte: nil,
+            limit: nil
+          )
+            @created = created
+            @created_gt = created_gt
+            @created_gte = created_gte
+            @created_lt = created_lt
+            @created_lte = created_lte
+            @limit = limit
+          end
+        end
+
+        class RetrieveParams < Stripe::RequestParams; end
+
+        # Retrieves a list of ReceivedCredits.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/money_management/received_credits",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieve a ReceivedCredit by ID.
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/money_management/received_credits/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/money_management/received_debit_service.rb

@@ -0,0 +1,43 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module MoneyManagement
+      class ReceivedDebitService < StripeService
+        class ListParams < Stripe::RequestParams
+          # The page limit.
+          attr_accessor :limit
+
+          def initialize(limit: nil)
+            @limit = limit
+          end
+        end
+
+        class RetrieveParams < Stripe::RequestParams; end
+
+        # Retrieves a list of ReceivedDebits, given the selected filters.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/money_management/received_debits",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieves a single ReceivedDebit by ID.
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/money_management/received_debits/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/money_management/transaction_entry_service.rb

@@ -0,0 +1,69 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module MoneyManagement
+      class TransactionEntryService < StripeService
+        class ListParams < Stripe::RequestParams
+          # Filter for Transactions created at an exact time.
+          attr_accessor :created
+          # Filter for Transactions created after the specified timestamp.
+          attr_accessor :created_gt
+          # Filter for Transactions created at or after the specified timestamp.
+          attr_accessor :created_gte
+          # Filter for Transactions created before the specified timestamp.
+          attr_accessor :created_lt
+          # Filter for Transactions created at or before the specified timestamp.
+          attr_accessor :created_lte
+          # The page limit.
+          attr_accessor :limit
+          # Filter for TransactionEntries belonging to a Transaction.
+          attr_accessor :transaction
+
+          def initialize(
+            created: nil,
+            created_gt: nil,
+            created_gte: nil,
+            created_lt: nil,
+            created_lte: nil,
+            limit: nil,
+            transaction: nil
+          )
+            @created = created
+            @created_gt = created_gt
+            @created_gte = created_gte
+            @created_lt = created_lt
+            @created_lte = created_lte
+            @limit = limit
+            @transaction = transaction
+          end
+        end
+
+        class RetrieveParams < Stripe::RequestParams; end
+
+        # Returns a list of TransactionEntries that match the provided filters.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/money_management/transaction_entries",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieves the details of a TransactionEntry by ID.
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/money_management/transaction_entries/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/money_management/transaction_service.rb

@@ -0,0 +1,73 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module MoneyManagement
+      class TransactionService < StripeService
+        class ListParams < Stripe::RequestParams
+          # Filter for Transactions created at an exact time.
+          attr_accessor :created
+          # Filter for Transactions created after the specified timestamp.
+          attr_accessor :created_gt
+          # Filter for Transactions created at or after the specified timestamp.
+          attr_accessor :created_gte
+          # Filter for Transactions created before the specified timestamp.
+          attr_accessor :created_lt
+          # Filter for Transactions created at or before the specified timestamp.
+          attr_accessor :created_lte
+          # Filter for Transactions belonging to a FinancialAccount.
+          attr_accessor :financial_account
+          # Filter for Transactions corresponding to a Flow.
+          attr_accessor :flow
+          # The page limit.
+          attr_accessor :limit
+
+          def initialize(
+            created: nil,
+            created_gt: nil,
+            created_gte: nil,
+            created_lt: nil,
+            created_lte: nil,
+            financial_account: nil,
+            flow: nil,
+            limit: nil
+          )
+            @created = created
+            @created_gt = created_gt
+            @created_gte = created_gte
+            @created_lt = created_lt
+            @created_lte = created_lte
+            @financial_account = financial_account
+            @flow = flow
+            @limit = limit
+          end
+        end
+
+        class RetrieveParams < Stripe::RequestParams; end
+
+        # Returns a list of Transactions that match the provided filters.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/money_management/transactions",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieves the details of a Transaction by ID.
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/money_management/transactions/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/money_management_service.rb

@@ -0,0 +1,31 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    class MoneyManagementService < StripeService
+      attr_reader :adjustments, :financial_accounts, :financial_addresses, :inbound_transfers, :outbound_payment_quotes, :outbound_payments, :outbound_setup_intents, :outbound_transfers, :payout_methods, :payout_methods_bank_account_spec, :received_credits, :received_debits, :transaction_entries, :transactions
+
+      def initialize(requestor)
+        super
+        @adjustments = Stripe::V2::MoneyManagement::AdjustmentService.new(@requestor)
+        @financial_accounts = Stripe::V2::MoneyManagement::FinancialAccountService.new(@requestor)
+        @financial_addresses = Stripe::V2::MoneyManagement::FinancialAddressService.new(@requestor)
+        @inbound_transfers = Stripe::V2::MoneyManagement::InboundTransferService.new(@requestor)
+        @outbound_payment_quotes = Stripe::V2::MoneyManagement::OutboundPaymentQuoteService
+                                   .new(@requestor)
+        @outbound_payments = Stripe::V2::MoneyManagement::OutboundPaymentService.new(@requestor)
+        @outbound_setup_intents = Stripe::V2::MoneyManagement::OutboundSetupIntentService
+                                  .new(@requestor)
+        @outbound_transfers = Stripe::V2::MoneyManagement::OutboundTransferService.new(@requestor)
+        @payout_methods = Stripe::V2::MoneyManagement::PayoutMethodService.new(@requestor)
+        @payout_methods_bank_account_spec = Stripe::V2::MoneyManagement::PayoutMethodsBankAccountSpecService
+                                            .new(@requestor)
+        @received_credits = Stripe::V2::MoneyManagement::ReceivedCreditService.new(@requestor)
+        @received_debits = Stripe::V2::MoneyManagement::ReceivedDebitService.new(@requestor)
+        @transaction_entries = Stripe::V2::MoneyManagement::TransactionEntryService.new(@requestor)
+        @transactions = Stripe::V2::MoneyManagement::TransactionService.new(@requestor)
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/payment_service.rb

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    class PaymentService < StripeService
+      attr_reader :off_session_payments
+
+      def initialize(requestor)
+        super
+        @off_session_payments = Stripe::V2::Payments::OffSessionPaymentService.new(@requestor)
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/payments/off_session_payment_service.rb

@@ -0,0 +1,152 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Payments
+      class OffSessionPaymentService < StripeService
+        class ListParams < Stripe::RequestParams
+          # The page size limit. If not provided, the default is 20.
+          attr_accessor :limit
+
+          def initialize(limit: nil)
+            @limit = limit
+          end
+        end
+
+        class CreateParams < Stripe::RequestParams
+          class RetryDetails < Stripe::RequestParams
+            # Indicates the strategy for how you want Stripe to retry the payment.
+            attr_accessor :retry_strategy
+
+            def initialize(retry_strategy: nil)
+              @retry_strategy = retry_strategy
+            end
+          end
+
+          class TransferData < Stripe::RequestParams
+            # The amount transferred to the destination account. This transfer will occur
+            # automatically after the payment succeeds. If no amount is specified, by default
+            # the entire payment amount is transferred to the destination account. The amount
+            # must be less than or equal to the
+            # [amount_requested](https://docs.corp.stripe.com/api/v2/off-session-payments/object?api-version=2025-05-28.preview#v2_off_session_payment_object-amount_requested),
+            # and must be a positive integer representing how much to transfer in the smallest
+            # currency unit (e.g., 100 cents to charge $1.00).
+            attr_accessor :amount
+            # The account (if any) that the payment is attributed to for tax reporting, and
+            # where funds from the payment are transferred to after payment success.
+            attr_accessor :destination
+
+            def initialize(amount: nil, destination: nil)
+              @amount = amount
+              @destination = destination
+            end
+          end
+          # The “presentment amount” to be collected from the customer.
+          attr_accessor :amount
+          # The frequency of the underlying payment.
+          attr_accessor :cadence
+          # ID of the Customer to which this OffSessionPayment belongs.
+          attr_accessor :customer
+          # Set of [key-value pairs](https://docs.corp.stripe.com/api/metadata) that you can
+          # attach to an object. This can be useful for storing additional information about
+          # the object in a structured format. Learn more about
+          # [storing information in metadata](https://docs.corp.stripe.com/payments/payment-intents#storing-information-in-metadata).
+          attr_accessor :metadata
+          # The account (if any) for which the funds of the OffSessionPayment are intended.
+          attr_accessor :on_behalf_of
+          # ID of the payment method used in this OffSessionPayment.
+          attr_accessor :payment_method
+          # Details about the OffSessionPayment retries.
+          attr_accessor :retry_details
+          # Text that appears on the customer’s statement as the statement descriptor for a
+          # non-card charge. This value overrides the account’s default statement descriptor.
+          # For information about requirements, including the 22-character limit, see the
+          # [Statement Descriptor docs](https://docs.stripe.com/get-started/account/statement-descriptors).
+          attr_accessor :statement_descriptor
+          # Provides information about a card charge. Concatenated to the account’s
+          # [statement descriptor prefix](https://docs.stripe.com/get-started/account/statement-descriptors#static)
+          # to form the complete statement descriptor that appears on the customer’s statement.
+          attr_accessor :statement_descriptor_suffix
+          # Test clock that can be used to advance the retry attempts in a sandbox.
+          attr_accessor :test_clock
+          # The data that automatically creates a Transfer after the payment finalizes. Learn more about the use case for [connected accounts](https://docs.corp.stripe.com/payments/connected-accounts).
+          attr_accessor :transfer_data
+
+          def initialize(
+            amount: nil,
+            cadence: nil,
+            customer: nil,
+            metadata: nil,
+            on_behalf_of: nil,
+            payment_method: nil,
+            retry_details: nil,
+            statement_descriptor: nil,
+            statement_descriptor_suffix: nil,
+            test_clock: nil,
+            transfer_data: nil
+          )
+            @amount = amount
+            @cadence = cadence
+            @customer = customer
+            @metadata = metadata
+            @on_behalf_of = on_behalf_of
+            @payment_method = payment_method
+            @retry_details = retry_details
+            @statement_descriptor = statement_descriptor
+            @statement_descriptor_suffix = statement_descriptor_suffix
+            @test_clock = test_clock
+            @transfer_data = transfer_data
+          end
+        end
+
+        class RetrieveParams < Stripe::RequestParams; end
+        class CancelParams < Stripe::RequestParams; end
+
+        # Cancel an OffSessionPayment that has previously been created.
+        def cancel(id, params = {}, opts = {})
+          request(
+            method: :post,
+            path: format("/v2/payments/off_session_payments/%<id>s/cancel", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Creates an OffSessionPayment object.
+        def create(params = {}, opts = {})
+          request(
+            method: :post,
+            path: "/v2/payments/off_session_payments",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Returns a list of OffSessionPayments matching a filter.
+        def list(params = {}, opts = {})
+          request(
+            method: :get,
+            path: "/v2/payments/off_session_payments",
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Retrieves the details of an OffSessionPayment that has previously been created.
+        def retrieve(id, params = {}, opts = {})
+          request(
+            method: :get,
+            path: format("/v2/payments/off_session_payments/%<id>s", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/test_helper_service.rb

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    class TestHelperService < StripeService
+      attr_reader :financial_addresses
+
+      def initialize(requestor)
+        super
+        @financial_addresses = Stripe::V2::TestHelpers::FinancialAddressService.new(@requestor)
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/test_helpers/financial_address_service.rb

@@ -0,0 +1,53 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module TestHelpers
+      class FinancialAddressService < StripeService
+        class CreditParams < Stripe::RequestParams
+          # Object containing the amount value and currency to credit.
+          attr_accessor :amount
+          # Open Enum. The network to use in simulating the funds flow. This will be the reflected in the resulting ReceivedCredit.
+          attr_accessor :network
+          # String explaining funds flow. Use this field to populate the statement descriptor of the ReceivedCredit created as an eventual result of this simulation.
+          attr_accessor :statement_descriptor
+
+          def initialize(amount: nil, network: nil, statement_descriptor: nil)
+            @amount = amount
+            @network = network
+            @statement_descriptor = statement_descriptor
+          end
+        end
+
+        class GenerateMicrodepositsParams < Stripe::RequestParams; end
+
+        # Simulate crediting a FinancialAddress in a Sandbox environment. This can be used to add virtual funds and increase your balance for testing.
+        #
+        # ** raises FeatureNotEnabledError
+        def credit(id, params = {}, opts = {})
+          request(
+            method: :post,
+            path: format("/v2/test_helpers/financial_addresses/%<id>s/credit", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+
+        # Generates microdeposits for a FinancialAddress in a Sandbox environment.
+        #
+        # ** raises FeatureNotEnabledError
+        def generate_microdeposits(id, params = {}, opts = {})
+          request(
+            method: :post,
+            path: format("/v2/test_helpers/financial_addresses/%<id>s/generate_microdeposits", { id: CGI.escape(id) }),
+            params: params,
+            opts: opts,
+            base_address: :api
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2_services.rb

@@ -3,12 +3,15 @@
 
 module Stripe
   class V2Services < StripeService
-    attr_reader :billing, :core
+    attr_reader :billing, :core, :money_management, :payments, :test_helpers
 
     def initialize(requestor)
       super
       @billing = Stripe::V2::BillingService.new(@requestor)
       @core = Stripe::V2::CoreService.new(@requestor)
+      @money_management = Stripe::V2::MoneyManagementService.new(@requestor)
+      @payments = Stripe::V2::PaymentService.new(@requestor)
+      @test_helpers = Stripe::V2::TestHelperService.new(@requestor)
     end
   end
 end