stripe 17.2.0 → 17.3.0.pre.alpha.2

data/lib/stripe/resources/tax/form.rb

@@ -0,0 +1,264 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Tax
+    # Tax forms are legal documents which are delivered to one or more tax authorities for information reporting purposes.
+    #
+    # Related guide: [US tax reporting for Connect platforms](https://stripe.com/docs/connect/tax-reporting)
+    class Form < APIResource
+      extend Stripe::APIOperations::List
+
+      OBJECT_NAME = "tax.form"
+      def self.object_name
+        "tax.form"
+      end
+
+      class AuSerr < ::Stripe::StripeObject
+        # End date of the period represented by the information reported on the tax form.
+        attr_reader :reporting_period_end_date
+        # Start date of the period represented by the information reported on the tax form.
+        attr_reader :reporting_period_start_date
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class CaMrdp < ::Stripe::StripeObject
+        # End date of the period represented by the information reported on the tax form.
+        attr_reader :reporting_period_end_date
+        # Start date of the period represented by the information reported on the tax form.
+        attr_reader :reporting_period_start_date
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class EuDac7 < ::Stripe::StripeObject
+        # End date of the period represented by the information reported on the tax form.
+        attr_reader :reporting_period_end_date
+        # Start date of the period represented by the information reported on the tax form.
+        attr_reader :reporting_period_start_date
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class FilingStatus < ::Stripe::StripeObject
+        class Jurisdiction < ::Stripe::StripeObject
+          # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+          attr_reader :country
+          # Indicates the level of the jurisdiction where the form was filed.
+          attr_reader :level
+          # [ISO 3166-2 U.S. state code](https://en.wikipedia.org/wiki/ISO_3166-2:US), without country prefix, if any. For example, "NY" for New York, United States. Null for non-U.S. forms.
+          attr_reader :state
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Time when the filing status was updated.
+        attr_reader :effective_at
+        # Attribute for field jurisdiction
+        attr_reader :jurisdiction
+        # The current status of the filed form.
+        attr_reader :value
+
+        def self.inner_class_types
+          @inner_class_types = { jurisdiction: Jurisdiction }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class GbMrdp < ::Stripe::StripeObject
+        # End date of the period represented by the information reported on the tax form.
+        attr_reader :reporting_period_end_date
+        # Start date of the period represented by the information reported on the tax form.
+        attr_reader :reporting_period_start_date
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class NzMrdp < ::Stripe::StripeObject
+        # End date of the period represented by the information reported on the tax form.
+        attr_reader :reporting_period_end_date
+        # Start date of the period represented by the information reported on the tax form.
+        attr_reader :reporting_period_start_date
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class Payee < ::Stripe::StripeObject
+        # The ID of the payee's Stripe account.
+        attr_reader :account
+        # The external reference to this payee.
+        attr_reader :external_reference
+        # Either `account` or `external_reference`.
+        attr_reader :type
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class Us1099K < ::Stripe::StripeObject
+        # Year represented by the information reported on the tax form.
+        attr_reader :reporting_year
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class Us1099Misc < ::Stripe::StripeObject
+        # Year represented by the information reported on the tax form.
+        attr_reader :reporting_year
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class Us1099Nec < ::Stripe::StripeObject
+        # Year represented by the information reported on the tax form.
+        attr_reader :reporting_year
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      # Attribute for field au_serr
+      attr_reader :au_serr
+      # Attribute for field ca_mrdp
+      attr_reader :ca_mrdp
+      # The form that corrects this form, if any.
+      attr_reader :corrected_by
+      # Time at which the object was created. Measured in seconds since the Unix epoch.
+      attr_reader :created
+      # Attribute for field eu_dac7
+      attr_reader :eu_dac7
+      # A list of tax filing statuses. Note that a filing status will only be included if the form has been filed directly with the jurisdiction’s tax authority.
+      attr_reader :filing_statuses
+      # Attribute for field gb_mrdp
+      attr_reader :gb_mrdp
+      # Unique identifier for the object.
+      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.
+      attr_reader :livemode
+      # Attribute for field nz_mrdp
+      attr_reader :nz_mrdp
+      # String representing the object's type. Objects of the same type share the same value.
+      attr_reader :object
+      # Attribute for field payee
+      attr_reader :payee
+      # The type of the tax form. An additional hash is included on the tax form with a name matching this value. It contains additional information specific to the tax form type.
+      attr_reader :type
+      # Attribute for field us_1099_k
+      attr_reader :us_1099_k
+      # Attribute for field us_1099_misc
+      attr_reader :us_1099_misc
+      # Attribute for field us_1099_nec
+      attr_reader :us_1099_nec
+
+      # Returns a list of tax forms which were previously created. The tax forms are returned in sorted order, with the oldest tax forms appearing first.
+      def self.list(params = {}, opts = {})
+        request_stripe_object(method: :get, path: "/v1/tax/forms", params: params, opts: opts)
+      end
+
+      # Download the PDF for a tax form.
+      def pdf(params = {}, opts = {}, &read_body_chunk_block)
+        opts = { api_base: APIRequestor.active_requestor.config.uploads_base }.merge(opts)
+        request_stream(
+          method: :get,
+          path: format("/v1/tax/forms/%<id>s/pdf", { id: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts,
+          base_address: :files,
+          &read_body_chunk_block
+        )
+      end
+
+      # Download the PDF for a tax form.
+      def self.pdf(id, params = {}, opts = {}, &read_body_chunk_block)
+        opts = { api_base: APIRequestor.active_requestor.config.uploads_base }.merge(opts)
+        execute_resource_request_stream(
+          :get,
+          format("/v1/tax/forms/%<id>s/pdf", { id: CGI.escape(id) }),
+          :files,
+          params,
+          opts,
+          &read_body_chunk_block
+        )
+      end
+
+      def self.inner_class_types
+        @inner_class_types = {
+          au_serr: AuSerr,
+          ca_mrdp: CaMrdp,
+          eu_dac7: EuDac7,
+          filing_statuses: FilingStatus,
+          gb_mrdp: GbMrdp,
+          nz_mrdp: NzMrdp,
+          payee: Payee,
+          us_1099_k: Us1099K,
+          us_1099_misc: Us1099Misc,
+          us_1099_nec: Us1099Nec,
+        }
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+  end
+end

data/lib/stripe/resources/tax_id.rb

@@ -23,6 +23,8 @@ module Stripe
       attr_reader :application
       # The customer being referenced when `type` is `customer`.
       attr_reader :customer
+      # The account being referenced when `type` is `customer`.
+      attr_reader :customer_account
       # Type of owner referenced.
       attr_reader :type
 
@@ -57,6 +59,8 @@ module Stripe
     attr_reader :created
     # ID of the customer.
     attr_reader :customer
+    # ID of the account.
+    attr_reader :customer_account
     # Unique identifier for the object.
     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.

data/lib/stripe/resources/terminal/configuration.rb

@@ -55,6 +55,19 @@ module Stripe
         end
       end
 
+      class ReaderSecurity < ::Stripe::StripeObject
+        # Passcode used to access a reader's admin menu.
+        attr_reader :admin_menu_passcode
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
       class RebootWindow < ::Stripe::StripeObject
         # Integer between 0 to 23 that represents the end hour of the reboot time window. The value must be different than the start_hour.
         attr_reader :end_hour
@@ -639,6 +652,8 @@ module Stripe
       attr_reader :object
       # Attribute for field offline
       attr_reader :offline
+      # Attribute for field reader_security
+      attr_reader :reader_security
       # Attribute for field reboot_window
       attr_reader :reboot_window
       # Attribute for field stripe_s700
@@ -707,6 +722,7 @@ module Stripe
           bbpos_wisepad3: BbposWisepad3,
           bbpos_wisepos_e: BbposWiseposE,
           offline: Offline,
+          reader_security: ReaderSecurity,
           reboot_window: RebootWindow,
           stripe_s700: StripeS700,
           tipping: Tipping,

data/lib/stripe/resources/terminal/onboarding_link.rb

@@ -0,0 +1,71 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Terminal
+    # Returns redirect links used for onboarding onto Tap to Pay on iPhone.
+    class OnboardingLink < APIResource
+      extend Stripe::APIOperations::Create
+
+      OBJECT_NAME = "terminal.onboarding_link"
+      def self.object_name
+        "terminal.onboarding_link"
+      end
+
+      class LinkOptions < ::Stripe::StripeObject
+        class AppleTermsAndConditions < ::Stripe::StripeObject
+          # Whether the link should also support users relinking their Apple account.
+          attr_reader :allow_relinking
+          # The business name of the merchant accepting Apple's Terms and Conditions.
+          attr_reader :merchant_display_name
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # The options associated with the Apple Terms and Conditions link type.
+        attr_reader :apple_terms_and_conditions
+
+        def self.inner_class_types
+          @inner_class_types = { apple_terms_and_conditions: AppleTermsAndConditions }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      # Link type options associated with the current onboarding link object.
+      attr_reader :link_options
+      # The type of link being generated.
+      attr_reader :link_type
+      # Attribute for field object
+      attr_reader :object
+      # Stripe account ID to generate the link for.
+      attr_reader :on_behalf_of
+      # The link passed back to the user for their onboarding.
+      attr_reader :redirect_url
+
+      # Creates a new OnboardingLink object that contains a redirect_url used for onboarding onto Tap to Pay on iPhone.
+      def self.create(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/terminal/onboarding_links",
+          params: params,
+          opts: opts
+        )
+      end
+
+      def self.inner_class_types
+        @inner_class_types = { link_options: LinkOptions }
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+  end
+end

data/lib/stripe/resources/terminal/reader.rb

@@ -238,6 +238,8 @@ module Stripe
               @field_remappings = {}
             end
           end
+          # Account the payment intent belongs to.
+          attr_reader :account
           # Represents a per-transaction override of a reader configuration
           attr_reader :collect_config
           # Most recent PaymentIntent processed by the reader.
@@ -271,6 +273,8 @@ module Stripe
               @field_remappings = {}
             end
           end
+          # Account the payment intent belongs to.
+          attr_reader :account
           # Represents a per-transaction override of a reader configuration
           attr_reader :confirm_config
           # Most recent PaymentIntent processed by the reader.
@@ -316,6 +320,8 @@ module Stripe
               @field_remappings = {}
             end
           end
+          # Account the payment intent belongs to.
+          attr_reader :account
           # Most recent PaymentIntent processed by the reader.
           attr_reader :payment_intent
           # Represents a per-transaction override of a reader configuration
@@ -372,6 +378,8 @@ module Stripe
               @field_remappings = {}
             end
           end
+          # Account the payment intent belongs to.
+          attr_reader :account
           # The amount being refunded.
           attr_reader :amount
           # Charge that is being refunded.

data/lib/stripe/resources/terminal/reader_collected_data.rb

@@ -0,0 +1,47 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Terminal
+    # Returns data collected by Terminal readers. This data is only stored for 24 hours.
+    class ReaderCollectedData < APIResource
+      OBJECT_NAME = "terminal.reader_collected_data"
+      def self.object_name
+        "terminal.reader_collected_data"
+      end
+
+      class Magstripe < ::Stripe::StripeObject
+        # The raw magstripe data collected by the reader.
+        attr_reader :data
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      # Time at which the object was created. Measured in seconds since the Unix epoch.
+      attr_reader :created
+      # Unique identifier for the object.
+      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.
+      attr_reader :livemode
+      # The magstripe data collected by the reader.
+      attr_reader :magstripe
+      # String representing the object's type. Objects of the same type share the same value.
+      attr_reader :object
+      # The type of data collected by the reader.
+      attr_reader :type
+
+      def self.inner_class_types
+        @inner_class_types = { magstripe: Magstripe }
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+  end
+end

data/lib/stripe/resources/transfer.rb

@@ -41,6 +41,8 @@ module Stripe
     attr_reader :destination
     # If the destination is a Stripe account, this will be the ID of the payment that the destination account received for the transfer.
     attr_reader :destination_payment
+    # The FX Quote used for the transfer.
+    attr_reader :fx_quote
     # Unique identifier for the object.
     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.
@@ -59,6 +61,10 @@ module Stripe
     attr_reader :source_type
     # A string that identifies this transaction as part of a group. See the [Connect documentation](https://stripe.com/docs/connect/separate-charges-and-transfers#transfer-options) for details.
     attr_reader :transfer_group
+    # Attribute for field application_fee
+    attr_reader :application_fee
+    # Attribute for field application_fee_amount
+    attr_reader :application_fee_amount
 
     # To send funds from your Stripe account to a connected account, you create a new transfer object. Your [Stripe balance](https://docs.stripe.com/api#balance) must be able to cover the transfer amount, or you'll receive an “Insufficient Funds” error.
     def self.create(params = {}, opts = {})

data/lib/stripe/resources/transit_balance.rb

@@ -0,0 +1,45 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # Funds that are in transit and destined for another balance or another connected account.
+  class TransitBalance < APIResource
+    OBJECT_NAME = "transit_balance"
+    def self.object_name
+      "transit_balance"
+    end
+
+    class Balance < ::Stripe::StripeObject
+      # Attribute for field available
+      attr_reader :available
+      # Attribute for field pending
+      attr_reader :pending
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+    # Attribute for field balance
+    attr_reader :balance
+    # Time at which the object was created. Measured in seconds since the Unix epoch.
+    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).
+    attr_reader :currency
+    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    attr_reader :livemode
+    # String representing the object's type. Objects of the same type share the same value.
+    attr_reader :object
+
+    def self.inner_class_types
+      @inner_class_types = { balance: Balance }
+    end
+
+    def self.field_remappings
+      @field_remappings = {}
+    end
+  end
+end

data/lib/stripe/resources/treasury/financial_account.rb

@@ -116,6 +116,8 @@ module Stripe
       attr_reader :country
       # Time at which the object was created. Measured in seconds since the Unix epoch.
       attr_reader :created
+      # The display name for the FinancialAccount. Use this field to customize the names of the FinancialAccounts for your connected accounts. Unlike the `nickname` field, `display_name` is not internal metadata and will be exposed to connected accounts.
+      attr_reader :display_name
       # Encodes whether a FinancialAccount has access to a particular Feature, with a `status` enum and associated `status_details`.
       # Stripe or the platform can control Features via the requested field.
       attr_reader :features

data/lib/stripe/resources/treasury/financial_account_features.rb

@@ -95,6 +95,8 @@ module Stripe
               @field_remappings = {}
             end
           end
+          # Requested bank partner for this Financial Account
+          attr_reader :bank
           # Whether the FinancialAccount should have the Feature.
           attr_reader :requested
           # Whether the Feature is operational.

data/lib/stripe/resources/treasury/outbound_transfer.rb

@@ -120,6 +120,33 @@ module Stripe
         end
       end
 
+      class NetworkDetails < ::Stripe::StripeObject
+        class Ach < ::Stripe::StripeObject
+          # ACH Addenda record
+          attr_reader :addenda
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Details about an ACH transaction.
+        attr_reader :ach
+        # The type of flow that originated the OutboundTransfer.
+        attr_reader :type
+
+        def self.inner_class_types
+          @inner_class_types = { ach: Ach }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
       class ReturnedDetails < ::Stripe::StripeObject
         # Reason for the return.
         attr_reader :code
@@ -225,6 +252,8 @@ module Stripe
       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.
       attr_reader :metadata
+      # Details about the network used for the OutboundTransfer.
+      attr_reader :network_details
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object
       # Details about a returned OutboundTransfer. Only set when the status is `returned`.
@@ -374,6 +403,7 @@ module Stripe
       def self.inner_class_types
         @inner_class_types = {
           destination_payment_method_details: DestinationPaymentMethodDetails,
+          network_details: NetworkDetails,
           returned_details: ReturnedDetails,
           status_transitions: StatusTransitions,
           tracking_details: TrackingDetails,

data/lib/stripe/resources/treasury/received_credit.rb

@@ -167,6 +167,33 @@ module Stripe
         end
       end
 
+      class NetworkDetails < ::Stripe::StripeObject
+        class Ach < ::Stripe::StripeObject
+          # ACH Addenda record
+          attr_reader :addenda
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Details about an ACH transaction.
+        attr_reader :ach
+        # The type of flow that originated the ReceivedCredit.
+        attr_reader :type
+
+        def self.inner_class_types
+          @inner_class_types = { ach: Ach }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
       class ReversalDetails < ::Stripe::StripeObject
         # Time before which a ReceivedCredit can be reversed.
         attr_reader :deadline
@@ -205,6 +232,8 @@ module Stripe
       attr_reader :livemode
       # The rails used to send the funds.
       attr_reader :network
+      # Details specific to the money movement rails.
+      attr_reader :network_details
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object
       # Details describing when a ReceivedCredit may be reversed.
@@ -249,6 +278,7 @@ module Stripe
         @inner_class_types = {
           initiating_payment_method_details: InitiatingPaymentMethodDetails,
           linked_flows: LinkedFlows,
+          network_details: NetworkDetails,
           reversal_details: ReversalDetails,
         }
       end