mega-pure-kit 0.0.1

data/stripe-19.3.0/lib/stripe/resources/issuing/cardholder.rb

@@ -0,0 +1,296 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Issuing
+    # An Issuing `Cardholder` object represents an individual or business entity who is [issued](https://docs.stripe.com/issuing) cards.
+    #
+    # Related guide: [How to create a cardholder](https://docs.stripe.com/issuing/cards/virtual/issue-cards#create-cardholder)
+    class Cardholder < APIResource
+      extend Stripe::APIOperations::Create
+      extend Stripe::APIOperations::List
+      include Stripe::APIOperations::Save
+
+      OBJECT_NAME = "issuing.cardholder"
+      def self.object_name
+        "issuing.cardholder"
+      end
+
+      class Billing < ::Stripe::StripeObject
+        class Address < ::Stripe::StripeObject
+          # City, district, suburb, town, or village.
+          attr_reader :city
+          # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+          attr_reader :country
+          # Address line 1, such as the street, PO Box, or company name.
+          attr_reader :line1
+          # Address line 2, such as the apartment, suite, unit, or building.
+          attr_reader :line2
+          # ZIP or postal code.
+          attr_reader :postal_code
+          # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
+          attr_reader :state
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Attribute for field address
+        attr_reader :address
+
+        def self.inner_class_types
+          @inner_class_types = { address: Address }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class Company < ::Stripe::StripeObject
+        # Whether the company's business ID number was provided.
+        attr_reader :tax_id_provided
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class Individual < ::Stripe::StripeObject
+        class CardIssuing < ::Stripe::StripeObject
+          class UserTermsAcceptance < ::Stripe::StripeObject
+            # The Unix timestamp marking when the cardholder accepted the Authorized User Terms.
+            attr_reader :date
+            # The IP address from which the cardholder accepted the Authorized User Terms.
+            attr_reader :ip
+            # The user agent of the browser from which the cardholder accepted the Authorized User Terms.
+            attr_reader :user_agent
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # Information about cardholder acceptance of Celtic [Authorized User Terms](https://stripe.com/docs/issuing/cards#accept-authorized-user-terms). Required for cards backed by a Celtic program.
+          attr_reader :user_terms_acceptance
+
+          def self.inner_class_types
+            @inner_class_types = { user_terms_acceptance: UserTermsAcceptance }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class Dob < ::Stripe::StripeObject
+          # The day of birth, between 1 and 31.
+          attr_reader :day
+          # The month of birth, between 1 and 12.
+          attr_reader :month
+          # The four-digit year of birth.
+          attr_reader :year
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        class Verification < ::Stripe::StripeObject
+          class Document < ::Stripe::StripeObject
+            # The back of a document returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`.
+            attr_reader :back
+            # The front of a document returned by a [file upload](https://api.stripe.com#create_file) with a `purpose` value of `identity_document`.
+            attr_reader :front
+
+            def self.inner_class_types
+              @inner_class_types = {}
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # An identifying document, either a passport or local ID card.
+          attr_reader :document
+
+          def self.inner_class_types
+            @inner_class_types = { document: Document }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Information related to the card_issuing program for this cardholder.
+        attr_reader :card_issuing
+        # The date of birth of this cardholder.
+        attr_reader :dob
+        # The first name of this cardholder. Required before activating Cards. This field cannot contain any numbers, special characters (except periods, commas, hyphens, spaces and apostrophes) or non-latin letters.
+        attr_reader :first_name
+        # The last name of this cardholder. Required before activating Cards. This field cannot contain any numbers, special characters (except periods, commas, hyphens, spaces and apostrophes) or non-latin letters.
+        attr_reader :last_name
+        # Government-issued ID document for this cardholder.
+        attr_reader :verification
+
+        def self.inner_class_types
+          @inner_class_types = { card_issuing: CardIssuing, dob: Dob, verification: Verification }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class Requirements < ::Stripe::StripeObject
+        # If `disabled_reason` is present, all cards will decline authorizations with `cardholder_verification_required` reason.
+        attr_reader :disabled_reason
+        # Array of fields that need to be collected in order to verify and re-enable the cardholder.
+        attr_reader :past_due
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class SpendingControls < ::Stripe::StripeObject
+        class SpendingLimit < ::Stripe::StripeObject
+          # Maximum amount allowed to spend per interval. This amount is in the card's currency and in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
+          attr_reader :amount
+          # Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) this limit applies to. Omitting this field will apply the limit to all categories.
+          attr_reader :categories
+          # Interval (or event) to which the amount applies.
+          attr_reader :interval
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Array of card presence statuses from which authorizations will be allowed. Possible options are `present`, `not_present`. All other statuses will be blocked. Cannot be set with `blocked_card_presences`. Provide an empty value to unset this control.
+        attr_reader :allowed_card_presences
+        # Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`.
+        attr_reader :allowed_categories
+        # Array of strings containing representing countries from which authorizations will be allowed. Authorizations from merchants in all other countries will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g. `US`). Cannot be set with `blocked_merchant_countries`. Provide an empty value to unset this control.
+        attr_reader :allowed_merchant_countries
+        # Array of card presence statuses from which authorizations will be declined. Possible options are `present`, `not_present`. Cannot be set with `allowed_card_presences`. Provide an empty value to unset this control.
+        attr_reader :blocked_card_presences
+        # Array of strings containing [categories](https://docs.stripe.com/api#issuing_authorization_object-merchant_data-category) of authorizations to decline. All other categories will be allowed. Cannot be set with `allowed_categories`.
+        attr_reader :blocked_categories
+        # Array of strings containing representing countries from which authorizations will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g. `US`). Cannot be set with `allowed_merchant_countries`. Provide an empty value to unset this control.
+        attr_reader :blocked_merchant_countries
+        # Limit spending with amount-based rules that apply across this cardholder's cards.
+        attr_reader :spending_limits
+        # Currency of the amounts within `spending_limits`.
+        attr_reader :spending_limits_currency
+
+        def self.inner_class_types
+          @inner_class_types = { spending_limits: SpendingLimit }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      # Attribute for field billing
+      attr_reader :billing
+      # Additional information about a `company` cardholder.
+      attr_reader :company
+      # Time at which the object was created. Measured in seconds since the Unix epoch.
+      attr_reader :created
+      # The cardholder's email address.
+      attr_reader :email
+      # Unique identifier for the object.
+      attr_reader :id
+      # Additional information about an `individual` cardholder.
+      attr_reader :individual
+      # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
+      attr_reader :livemode
+      # Set of [key-value pairs](https://docs.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.
+      attr_reader :metadata
+      # The cardholder's name. This will be printed on cards issued to them.
+      attr_reader :name
+      # String representing the object's type. Objects of the same type share the same value.
+      attr_reader :object
+      # The cardholder's phone number. This is required for all cardholders who will be creating EU cards. See the [3D Secure documentation](https://docs.stripe.com/issuing/3d-secure#when-is-3d-secure-applied) for more details.
+      attr_reader :phone_number
+      # The cardholder’s preferred locales (languages), ordered by preference. Locales can be `da`, `de`, `en`, `es`, `fr`, `it`, `pl`, or `sv`.
+      #  This changes the language of the [3D Secure flow](https://docs.stripe.com/issuing/3d-secure) and one-time password messages sent to the cardholder.
+      attr_reader :preferred_locales
+      # Attribute for field requirements
+      attr_reader :requirements
+      # Rules that control spending across this cardholder's cards. Refer to our [documentation](https://docs.stripe.com/issuing/controls/spending-controls) for more details.
+      attr_reader :spending_controls
+      # Specifies whether to permit authorizations on this cardholder's cards.
+      attr_reader :status
+      # One of `individual` or `company`. See [Choose a cardholder type](https://docs.stripe.com/issuing/other/choose-cardholder) for more details.
+      attr_reader :type
+
+      # Creates a new Issuing Cardholder object that can be issued cards.
+      def self.create(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/issuing/cardholders",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Returns a list of Issuing Cardholder 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/cardholders",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Updates the specified Issuing Cardholder object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
+      def self.update(cardholder, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/issuing/cardholders/%<cardholder>s", { cardholder: CGI.escape(cardholder) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      def self.inner_class_types
+        @inner_class_types = {
+          billing: Billing,
+          company: Company,
+          individual: Individual,
+          requirements: Requirements,
+          spending_controls: SpendingControls,
+        }
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+  end
+end

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

@@ -0,0 +1,324 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Issuing
+    # As a [card issuer](https://docs.stripe.com/issuing), you can dispute transactions that the cardholder does not recognize, suspects to be fraudulent, or has other issues with.
+    #
+    # Related guide: [Issuing disputes](https://docs.stripe.com/issuing/purchases/disputes)
+    class Dispute < APIResource
+      extend Stripe::APIOperations::Create
+      extend Stripe::APIOperations::List
+      include Stripe::APIOperations::Save
+
+      OBJECT_NAME = "issuing.dispute"
+      def self.object_name
+        "issuing.dispute"
+      end
+
+      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.
+          attr_reader :canceled_at
+          # Whether the cardholder was provided with a cancellation policy.
+          attr_reader :cancellation_policy_provided
+          # Reason for canceling the order.
+          attr_reader :cancellation_reason
+          # Date when the cardholder expected to receive the product.
+          attr_reader :expected_at
+          # Explanation of why the cardholder is disputing this transaction.
+          attr_reader :explanation
+          # Description of the merchandise or service that was purchased.
+          attr_reader :product_description
+          # Whether the product was a merchandise or service.
+          attr_reader :product_type
+          # Result of cardholder's attempt to return the product.
+          attr_reader :return_status
+          # Date when the product was returned or attempted to be returned.
+          attr_reader :returned_at
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        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.
+          attr_reader :card_statement
+          # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Copy of the receipt showing that the product had been paid for in cash.
+          attr_reader :cash_receipt
+          # (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Image of the front and back of the check that was used to pay for the product.
+          attr_reader :check_image
+          # Explanation of why the cardholder is disputing this transaction.
+          attr_reader :explanation
+          # Transaction (e.g., ipi_...) that the disputed transaction is a duplicate of. Of the two or more transactions that are copies of each other, this is original undisputed one.
+          attr_reader :original_transaction
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        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.
+          attr_reader :explanation
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        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.
+          attr_reader :explanation
+          # Date when the product was received.
+          attr_reader :received_at
+          # Description of the cardholder's attempt to return the product.
+          attr_reader :return_description
+          # Result of cardholder's attempt to return the product.
+          attr_reader :return_status
+          # Date when the product was returned or attempted to be returned.
+          attr_reader :returned_at
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        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.
+          attr_reader :explanation
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        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.
+          attr_reader :expected_at
+          # Explanation of why the cardholder is disputing this transaction.
+          attr_reader :explanation
+          # Description of the merchandise or service that was purchased.
+          attr_reader :product_description
+          # Whether the product was a merchandise or service.
+          attr_reader :product_type
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        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.
+          attr_reader :explanation
+          # Description of the merchandise or service that was purchased.
+          attr_reader :product_description
+          # Whether the product was a merchandise or service.
+          attr_reader :product_type
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
+        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.
+          attr_reader :canceled_at
+          # Reason for canceling the order.
+          attr_reader :cancellation_reason
+          # Explanation of why the cardholder is disputing this transaction.
+          attr_reader :explanation
+          # Date when the product was received.
+          attr_reader :received_at
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Attribute for field canceled
+        attr_reader :canceled
+        # Attribute for field duplicate
+        attr_reader :duplicate
+        # Attribute for field fraudulent
+        attr_reader :fraudulent
+        # Attribute for field merchandise_not_as_described
+        attr_reader :merchandise_not_as_described
+        # Attribute for field no_valid_authorization
+        attr_reader :no_valid_authorization
+        # Attribute for field not_received
+        attr_reader :not_received
+        # Attribute for field other
+        attr_reader :other
+        # The reason for filing the dispute. Its value will match the field containing the evidence.
+        attr_reader :reason
+        # Attribute for field service_not_as_described
+        attr_reader :service_not_as_described
+
+        def self.inner_class_types
+          @inner_class_types = {
+            canceled: Canceled,
+            duplicate: Duplicate,
+            fraudulent: Fraudulent,
+            merchandise_not_as_described: MerchandiseNotAsDescribed,
+            no_valid_authorization: NoValidAuthorization,
+            not_received: NotReceived,
+            other: Other,
+            service_not_as_described: ServiceNotAsDescribed,
+          }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class Treasury < ::Stripe::StripeObject
+        # The Treasury [DebitReversal](https://docs.stripe.com/api/treasury/debit_reversals) representing this Issuing dispute
+        attr_reader :debit_reversal
+        # The Treasury [ReceivedDebit](https://docs.stripe.com/api/treasury/received_debits) that is being disputed.
+        attr_reader :received_debit
+
+        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](https://docs.stripe.com/currencies#zero-decimal). Usually the amount of the `transaction`, but can differ (usually because of currency fluctuation).
+      attr_reader :amount
+      # List of balance transactions associated with the dispute.
+      attr_reader :balance_transactions
+      # Time at which the object was created. Measured in seconds since the Unix epoch.
+      attr_reader :created
+      # The currency the `transaction` was made in.
+      attr_reader :currency
+      # Attribute for field evidence
+      attr_reader :evidence
+      # Unique identifier for the object.
+      attr_reader :id
+      # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
+      attr_reader :livemode
+      # The enum that describes the dispute loss outcome. If the dispute is not lost, this field will be absent. New enum values may be added in the future, so be sure to handle unknown values.
+      attr_reader :loss_reason
+      # Set of [key-value pairs](https://docs.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.
+      attr_reader :metadata
+      # String representing the object's type. Objects of the same type share the same value.
+      attr_reader :object
+      # Current status of the dispute.
+      attr_reader :status
+      # The transaction being disputed.
+      attr_reader :transaction
+      # [Treasury](https://docs.stripe.com/api/treasury) details related to this dispute if it was created on a [FinancialAccount](https://docs.stripe.com/api/treasury/financial_accounts)
+      attr_reader :treasury
+
+      # Creates an Issuing Dispute object. Individual pieces of evidence within the evidence object are optional at this point. Stripe only validates that required evidence is present during submission. Refer to [Dispute reasons and evidence](https://docs.stripe.com/docs/issuing/purchases/disputes#dispute-reasons-and-evidence) for more details about evidence requirements.
+      def self.create(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: "/v1/issuing/disputes",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Returns a list of Issuing Dispute 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/disputes",
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Submits an Issuing Dispute to the card network. Stripe validates that all evidence fields required for the dispute's reason are present. For more details, see [Dispute reasons and evidence](https://docs.stripe.com/docs/issuing/purchases/disputes#dispute-reasons-and-evidence).
+      def submit(params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/issuing/disputes/%<dispute>s/submit", { dispute: CGI.escape(self["id"]) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Submits an Issuing Dispute to the card network. Stripe validates that all evidence fields required for the dispute's reason are present. For more details, see [Dispute reasons and evidence](https://docs.stripe.com/docs/issuing/purchases/disputes#dispute-reasons-and-evidence).
+      def self.submit(dispute, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/issuing/disputes/%<dispute>s/submit", { dispute: CGI.escape(dispute) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      # Updates the specified Issuing Dispute object by setting the values of the parameters passed. Any parameters not provided will be left unchanged. Properties on the evidence object can be unset by passing in an empty string.
+      def self.update(dispute, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/issuing/disputes/%<dispute>s", { dispute: CGI.escape(dispute) }),
+          params: params,
+          opts: opts
+        )
+      end
+
+      def self.inner_class_types
+        @inner_class_types = { evidence: Evidence, treasury: Treasury }
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+  end
+end