stripe 17.0.0 → 17.1.0.pre.alpha.1

data/lib/stripe/resources/issuing/credit_underwriting_record.rb

@@ -0,0 +1,263 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Issuing
+    # Every time an applicant submits an application for a Charge Card product your platform offers, or every time your platform takes a proactive credit decision on an existing account, you must record the decision by creating a new `CreditUnderwritingRecord` object on a connected account.
+    #
+    # [Follow the guide](https://stripe.com/docs/issuing/credit/report-credit-decisions-and-manage-aans) to learn about your requirements as a platform.
+    class CreditUnderwritingRecord < APIResource
+      extend Stripe::APIOperations::List
+
+      OBJECT_NAME = "issuing.credit_underwriting_record"
+      def self.object_name
+        "issuing.credit_underwriting_record"
+      end
+
+      class Application < ::Stripe::StripeObject
+        # The channel through which the applicant has submitted their application.
+        attr_reader :application_method
+        # Scope of demand made by the applicant.
+        attr_reader :purpose
+        # Date when the applicant submitted their application.
+        attr_reader :submitted_at
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class CreditUser < ::Stripe::StripeObject
+        # Email of the applicant or accountholder.
+        attr_reader :email
+        # Full name of the company or person.
+        attr_reader :name
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class Decision < ::Stripe::StripeObject
+        class ApplicationRejected < ::Stripe::StripeObject
+          # Details about the `reasons.other` when present.
+          attr_reader :reason_other_explanation
+          # List of reasons why the application was rejected up to 4 reasons, in order of importance.
+          attr_reader :reasons
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class CreditLimitApproved < ::Stripe::StripeObject
+          # Credit amount approved. An approved credit limit is required before you can set a amount in the [CreditPolicy API](https://stripe.com/docs/api/issuing/credit_policy).
+          attr_reader :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).
+          attr_reader :currency
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class CreditLimitDecreased < ::Stripe::StripeObject
+          # Credit amount approved after decrease. An approved credit limit is required before you can set a amount in the [CreditPolicy API](https://stripe.com/docs/api/issuing/credit_policy).
+          attr_reader :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).
+          attr_reader :currency
+          # Details about the `reasons.other` when present.
+          attr_reader :reason_other_explanation
+          # List of reasons why the existing credit was decreased, up to 4 reasons, in order of importance.
+          attr_reader :reasons
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class CreditLineClosed < ::Stripe::StripeObject
+          # Details about the `reasons.other` when present.
+          attr_reader :reason_other_explanation
+          # List of reasons why the existing account was closed, up to 4 reasons, in order of importance.
+          attr_reader :reasons
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Details about a decision application_rejected.
+        attr_reader :application_rejected
+        # Details about a decision credit_limit_approved.
+        attr_reader :credit_limit_approved
+        # Details about a decision credit_limit_decreased.
+        attr_reader :credit_limit_decreased
+        # Details about a decision credit_line_closed.
+        attr_reader :credit_line_closed
+        # Outcome of the decision.
+        attr_reader :type
+
+        def self.inner_class_types
+          @inner_class_types = {
+            application_rejected: ApplicationRejected,
+            credit_limit_approved: CreditLimitApproved,
+            credit_limit_decreased: CreditLimitDecreased,
+            credit_line_closed: CreditLineClosed,
+          }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class UnderwritingException < ::Stripe::StripeObject
+        # Written explanation for the exception.
+        attr_reader :explanation
+        # The decision before the exception was applied.
+        attr_reader :original_decision_type
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      # For decisions triggered by an application, details about the submission.
+      attr_reader :application
+      # Time at which the object was created. Measured in seconds since the Unix epoch.
+      attr_reader :created
+      # The event that triggered the underwriting.
+      attr_reader :created_from
+      # Attribute for field credit_user
+      attr_reader :credit_user
+      # Date when a decision was made.
+      attr_reader :decided_at
+      # Details about the decision.
+      attr_reader :decision
+      # For underwriting initiated by an application, a decision must be taken 30 days after the submission.
+      attr_reader :decision_deadline
+      # 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
+      # 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
+      # String representing the object's type. Objects of the same type share the same value.
+      attr_reader :object
+      # File containing regulatory reporting data for the decision. Required if you are subject to this [reporting requirement](https://stripe.com/docs/issuing/credit/report-required-regulatory-data-for-credit-decisions).
+      attr_reader :regulatory_reporting_file
+      # If an exception to the usual underwriting criteria was made for this application, details about the exception must be provided. Exceptions should only be granted in rare circumstances, in consultation with Stripe Compliance.
+      attr_reader :underwriting_exception
+
+      # Update a CreditUnderwritingRecord object to correct mistakes.
+      def correct(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/issuing/credit_underwriting_records/%<credit_underwriting_record>s/correct", { credit_underwriting_record: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Update a CreditUnderwritingRecord object to correct mistakes.
+      def self.correct(credit_underwriting_record, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/issuing/credit_underwriting_records/%<credit_underwriting_record>s/correct", { credit_underwriting_record: CGI.escape(credit_underwriting_record) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Creates a CreditUnderwritingRecord object with information about a credit application submission.
+      def self.create_from_application(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/issuing/credit_underwriting_records/create_from_application",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Creates a CreditUnderwritingRecord object from an underwriting decision coming from a proactive review of an existing accountholder.
+      def self.create_from_proactive_review(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/issuing/credit_underwriting_records/create_from_proactive_review",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Retrieves a list of CreditUnderwritingRecord objects. The objects are sorted in descending order by creation date, with the most-recently-created object appearing first.
+      def self.list(params = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/issuing/credit_underwriting_records",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Update a CreditUnderwritingRecord object from a decision made on a credit application.
+      def report_decision(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/issuing/credit_underwriting_records/%<credit_underwriting_record>s/report_decision", { credit_underwriting_record: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Update a CreditUnderwritingRecord object from a decision made on a credit application.
+      def self.report_decision(credit_underwriting_record, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/issuing/credit_underwriting_records/%<credit_underwriting_record>s/report_decision", { credit_underwriting_record: CGI.escape(credit_underwriting_record) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      def self.inner_class_types
+        @inner_class_types = {
+          application: Application,
+          credit_user: CreditUser,
+          decision: Decision,
+          underwriting_exception: UnderwritingException,
+        }
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+  end
+end

data/lib/stripe/resources/issuing/dispute.rb

@@ -16,8 +16,8 @@ module Stripe
         "issuing.dispute"
       end
 
-      class Evidence < Stripe::StripeObject
-        class Canceled < Stripe::StripeObject
+      class Evidence < ::Stripe::StripeObject
+        class Canceled < ::Stripe::StripeObject
           # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Additional documentation supporting the dispute.
           attr_reader :additional_documentation
           # Date when order was canceled.
@@ -48,7 +48,7 @@ module Stripe
           end
         end
 
-        class Duplicate < Stripe::StripeObject
+        class Duplicate < ::Stripe::StripeObject
           # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Additional documentation supporting the dispute.
           attr_reader :additional_documentation
           # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Copy of the card statement showing that the product had already been paid for.
@@ -71,7 +71,7 @@ module Stripe
           end
         end
 
-        class Fraudulent < Stripe::StripeObject
+        class Fraudulent < ::Stripe::StripeObject
           # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Additional documentation supporting the dispute.
           attr_reader :additional_documentation
           # Explanation of why the cardholder is disputing this transaction.
@@ -86,7 +86,7 @@ module Stripe
           end
         end
 
-        class MerchandiseNotAsDescribed < Stripe::StripeObject
+        class MerchandiseNotAsDescribed < ::Stripe::StripeObject
           # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Additional documentation supporting the dispute.
           attr_reader :additional_documentation
           # Explanation of why the cardholder is disputing this transaction.
@@ -109,7 +109,7 @@ module Stripe
           end
         end
 
-        class NoValidAuthorization < Stripe::StripeObject
+        class NoValidAuthorization < ::Stripe::StripeObject
           # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Additional documentation supporting the dispute.
           attr_reader :additional_documentation
           # Explanation of why the cardholder is disputing this transaction.
@@ -124,7 +124,7 @@ module Stripe
           end
         end
 
-        class NotReceived < Stripe::StripeObject
+        class NotReceived < ::Stripe::StripeObject
           # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Additional documentation supporting the dispute.
           attr_reader :additional_documentation
           # Date when the cardholder expected to receive the product.
@@ -145,7 +145,7 @@ module Stripe
           end
         end
 
-        class Other < Stripe::StripeObject
+        class Other < ::Stripe::StripeObject
           # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Additional documentation supporting the dispute.
           attr_reader :additional_documentation
           # Explanation of why the cardholder is disputing this transaction.
@@ -164,7 +164,7 @@ module Stripe
           end
         end
 
-        class ServiceNotAsDescribed < Stripe::StripeObject
+        class ServiceNotAsDescribed < ::Stripe::StripeObject
           # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Additional documentation supporting the dispute.
           attr_reader :additional_documentation
           # Date when order was canceled.
@@ -221,7 +221,7 @@ module Stripe
         end
       end
 
-      class Treasury < Stripe::StripeObject
+      class Treasury < ::Stripe::StripeObject
         # The Treasury [DebitReversal](https://stripe.com/docs/api/treasury/debit_reversals) representing this Issuing dispute
         attr_reader :debit_reversal
         # The Treasury [ReceivedDebit](https://stripe.com/docs/api/treasury/received_debits) that is being disputed.

data/lib/stripe/resources/issuing/dispute_settlement_detail.rb

@@ -0,0 +1,71 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Issuing
+    # Represents a record from the card network of a money movement or change in state for an Issuing dispute. These records are included in the settlement reports that we receive from networks and expose to users as Settlement objects.
+    class DisputeSettlementDetail < APIResource
+      extend Stripe::APIOperations::List
+
+      OBJECT_NAME = "issuing.dispute_settlement_detail"
+      def self.object_name
+        "issuing.dispute_settlement_detail"
+      end
+
+      class NetworkData < ::Stripe::StripeObject
+        # The date the transaction was processed by the card network. This can be different from the date the seller recorded the transaction depending on when the acquirer submits the transaction to the network.
+        attr_reader :processing_date
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      # Disputed amount in the card’s currency and in the smallest currency unit. Usually the amount of the transaction, but can differ (usually because of currency fluctuation).
+      attr_reader :amount
+      # The card used to make the original transaction.
+      attr_reader :card
+      # Time at which the object was created. Measured in seconds since the Unix epoch.
+      attr_reader :created
+      # The currency the original transaction was made in. 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
+      # The ID of the linked dispute.
+      attr_reader :dispute
+      # The type of event corresponding to this dispute settlement detail, representing the stage in the dispute network lifecycle.
+      attr_reader :event_type
+      # 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 card network for this dispute settlement detail. One of ["visa", "mastercard", "maestro"]
+      attr_reader :network
+      # Details about the transaction, such as processing dates, set by the card network.
+      attr_reader :network_data
+      # String representing the object's type. Objects of the same type share the same value.
+      attr_reader :object
+      # The ID of the linked card network settlement.
+      attr_reader :settlement
+
+      # Returns a list of Issuing DisputeSettlementDetail objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
+      def self.list(params = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/issuing/dispute_settlement_details",
+          params: params,
+          opts: opts
+        )
+      end
+
+      def self.inner_class_types
+        @inner_class_types = { network_data: NetworkData }
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+  end
+end

data/lib/stripe/resources/issuing/fraud_liability_debit.rb

@@ -0,0 +1,51 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Issuing
+    # A fraud liability debit occurs when Stripe debits a platform's account for fraud losses on Issuing transactions.
+    class FraudLiabilityDebit < APIResource
+      extend Stripe::APIOperations::List
+
+      OBJECT_NAME = "issuing.fraud_liability_debit"
+      def self.object_name
+        "issuing.fraud_liability_debit"
+      end
+
+      # Debited amount. This is equal to the disputed amount and is given in the card’s currency and in the smallest currency unit.
+      attr_reader :amount
+      # ID of the [balance transaction](https://stripe.com/docs/api/balance_transactions) associated with this debit.
+      attr_reader :balance_transaction
+      # Time at which the object was created. Measured in seconds since the Unix epoch.
+      attr_reader :created
+      # The currency of the debit. 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
+      # The ID of the linked dispute.
+      attr_reader :dispute
+      # 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
+      # String representing the object's type. Objects of the same type share the same value.
+      attr_reader :object
+
+      # Returns a list of Issuing FraudLiabilityDebit objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
+      def self.list(params = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/issuing/fraud_liability_debits",
+          params: params,
+          opts: opts
+        )
+      end
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+  end
+end

data/lib/stripe/resources/issuing/personalization_design.rb

@@ -14,7 +14,7 @@ module Stripe
         "issuing.personalization_design"
       end
 
-      class CarrierText < Stripe::StripeObject
+      class CarrierText < ::Stripe::StripeObject
         # The footer body text of the carrier letter.
         attr_reader :footer_body
         # The footer title text of the carrier letter.
@@ -33,7 +33,7 @@ module Stripe
         end
       end
 
-      class Preferences < Stripe::StripeObject
+      class Preferences < ::Stripe::StripeObject
         # Whether we use this personalization design to create cards when one isn't specified. A connected account uses the Connect platform's default design if no personalization design is set as the default design.
         attr_reader :is_default
         # Whether this personalization design is used to create cards when one is not specified and a default for this connected account does not exist.
@@ -48,7 +48,7 @@ module Stripe
         end
       end
 
-      class RejectionReasons < Stripe::StripeObject
+      class RejectionReasons < ::Stripe::StripeObject
         # The reason(s) the card logo was rejected.
         attr_reader :card_logo
         # The reason(s) the carrier text was rejected.

data/lib/stripe/resources/issuing/physical_bundle.rb

@@ -12,7 +12,7 @@ module Stripe
         "issuing.physical_bundle"
       end
 
-      class Features < Stripe::StripeObject
+      class Features < ::Stripe::StripeObject
         # The policy for how to use card logo images in a card design with this physical bundle.
         attr_reader :card_logo
         # The policy for how to use carrier letter text in a card design with this physical bundle.

data/lib/stripe/resources/issuing/settlement.rb

@@ -0,0 +1,61 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Issuing
+    # When a non-stripe BIN is used, any use of an [issued card](https://stripe.com/docs/issuing) must be settled directly with the card network. The net amount owed is represented by an Issuing `Settlement` object.
+    class Settlement < APIResource
+      OBJECT_NAME = "issuing.settlement"
+      def self.object_name
+        "issuing.settlement"
+      end
+
+      # The Bank Identification Number reflecting this settlement record.
+      attr_reader :bin
+      # The date that the transactions are cleared and posted to user's accounts.
+      attr_reader :clearing_date
+      # 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
+      # Unique identifier for the object.
+      attr_reader :id
+      # The total interchange received as reimbursement for the transactions.
+      attr_reader :interchange_fees_amount
+      # 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
+      # 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
+      # The total net amount required to settle with the network.
+      attr_reader :net_total_amount
+      # The card network for this settlement report. One of ["visa", "maestro"]
+      attr_reader :network
+      # The total amount of fees owed to the network.
+      attr_reader :network_fees_amount
+      # The Settlement Identification Number assigned by the network.
+      attr_reader :network_settlement_identifier
+      # String representing the object's type. Objects of the same type share the same value.
+      attr_reader :object
+      # The total amount of any additional fees assessed by the card network.
+      attr_reader :other_fees_amount
+      # The total number of additional fees assessed by the card network.
+      attr_reader :other_fees_count
+      # One of `international` or `uk_national_net`.
+      attr_reader :settlement_service
+      # The current processing status of this settlement.
+      attr_reader :status
+      # The total transaction amount reflected in this settlement.
+      attr_reader :transaction_amount
+      # The total number of transactions reflected in this settlement.
+      attr_reader :transaction_count
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+  end
+end

data/lib/stripe/resources/issuing/token.rb

@@ -13,8 +13,8 @@ module Stripe
         "issuing.token"
       end
 
-      class NetworkData < Stripe::StripeObject
-        class Device < Stripe::StripeObject
+      class NetworkData < ::Stripe::StripeObject
+        class Device < ::Stripe::StripeObject
           # An obfuscated ID derived from the device ID.
           attr_reader :device_fingerprint
           # The IP address of the device at provisioning time.
@@ -37,7 +37,7 @@ module Stripe
           end
         end
 
-        class Mastercard < Stripe::StripeObject
+        class Mastercard < ::Stripe::StripeObject
           # A unique reference ID from MasterCard to represent the card account number.
           attr_reader :card_reference_id
           # The network-unique identifier for the token.
@@ -56,7 +56,7 @@ module Stripe
           end
         end
 
-        class Visa < Stripe::StripeObject
+        class Visa < ::Stripe::StripeObject
           # A unique reference ID from Visa to represent the card account number.
           attr_reader :card_reference_id
           # The network-unique identifier for the token.
@@ -75,8 +75,8 @@ module Stripe
           end
         end
 
-        class WalletProvider < Stripe::StripeObject
-          class CardholderAddress < Stripe::StripeObject
+        class WalletProvider < ::Stripe::StripeObject
+          class CardholderAddress < ::Stripe::StripeObject
             # The street address of the cardholder tokenizing the card.
             attr_reader :line1
             # The postal code of the cardholder tokenizing the card.