stripe 13.2.0 → 13.3.0.pre.beta.2

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

@@ -0,0 +1,43 @@
+# 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(filters = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/issuing/fraud_liability_debits",
+          params: filters,
+          opts: opts
+        )
+      end
+    end
+  end
+end

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

@@ -14,6 +14,44 @@ module Stripe
         "issuing.personalization_design"
       end
 
+      class CarrierText < Stripe::StripeObject
+        attr_reader :footer_body, :footer_title, :header_body, :header_title
+      end
+
+      class Preferences < Stripe::StripeObject
+        attr_reader :is_default, :is_platform_default
+      end
+
+      class RejectionReasons < Stripe::StripeObject
+        attr_reader :card_logo, :carrier_text
+      end
+      # The file for the card logo to use with physical bundles that support card logos. Must have a `purpose` value of `issuing_logo`.
+      attr_reader :card_logo
+      # Hash containing carrier text, for use with physical bundles that support carrier text.
+      attr_reader :carrier_text
+      # 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
+      # A lookup key used to retrieve personalization designs dynamically from a static string. This may be up to 200 characters.
+      attr_reader :lookup_key
+      # 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
+      # Friendly display name.
+      attr_reader :name
+      # String representing the object's type. Objects of the same type share the same value.
+      attr_reader :object
+      # The physical bundle object belonging to this personalization design.
+      attr_reader :physical_bundle
+      # Attribute for field preferences
+      attr_reader :preferences
+      # Attribute for field rejection_reasons
+      attr_reader :rejection_reasons
+      # Whether this personalization design can be used to create cards.
+      attr_reader :status
+
       # Creates a personalization design object.
       def self.create(params = {}, opts = {})
         request_stripe_object(

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

@@ -12,6 +12,24 @@ module Stripe
         "issuing.physical_bundle"
       end
 
+      class Features < Stripe::StripeObject
+        attr_reader :card_logo, :carrier_text, :second_line
+      end
+      # Attribute for field features
+      attr_reader :features
+      # 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
+      # Friendly display name.
+      attr_reader :name
+      # String representing the object's type. Objects of the same type share the same value.
+      attr_reader :object
+      # Whether this physical bundle can be used to create cards.
+      attr_reader :status
+      # Whether this physical bundle is a standard Stripe offering or custom-made for you.
+      attr_reader :type
+
       # Returns a list of physical bundle objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
       def self.list(filters = {}, opts = {})
         request_stripe_object(

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

@@ -0,0 +1,49 @@
+# 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
+      # 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
+      # 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
+      # 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
+      # One of `international` or `uk_national_net`.
+      attr_reader :settlement_service
+      # The current processing status of this settlement.
+      attr_reader :status
+      # The total number of transactions reflected in this settlement.
+      attr_reader :transaction_count
+      # The total transaction amount reflected in this settlement.
+      attr_reader :transaction_volume
+    end
+  end
+end

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

@@ -13,6 +13,52 @@ module Stripe
         "issuing.token"
       end
 
+      class NetworkData < Stripe::StripeObject
+        class Device < Stripe::StripeObject
+          attr_reader :device_fingerprint, :ip_address, :location, :name, :phone_number, :type
+        end
+
+        class Mastercard < Stripe::StripeObject
+          attr_reader :card_reference_id, :token_reference_id, :token_requestor_id, :token_requestor_name
+        end
+
+        class Visa < Stripe::StripeObject
+          attr_reader :card_reference_id, :token_reference_id, :token_requestor_id, :token_risk_score
+        end
+
+        class WalletProvider < Stripe::StripeObject
+          class CardholderAddress < Stripe::StripeObject
+            attr_reader :line1, :postal_code
+          end
+          attr_reader :account_id, :account_trust_score, :card_number_source, :cardholder_address, :cardholder_name, :device_trust_score, :hashed_account_email_address, :reason_codes, :suggested_decision, :suggested_decision_version
+        end
+        attr_reader :device, :mastercard, :type, :visa, :wallet_provider
+      end
+      # Card associated with this token.
+      attr_reader :card
+      # Time at which the object was created. Measured in seconds since the Unix epoch.
+      attr_reader :created
+      # The hashed ID derived from the device ID from the card network associated with the token.
+      attr_reader :device_fingerprint
+      # Unique identifier for the object.
+      attr_reader :id
+      # The last four digits of the token.
+      attr_reader :last4
+      # 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 token service provider / card network associated with the token.
+      attr_reader :network
+      # Attribute for field network_data
+      attr_reader :network_data
+      # Time at which the token was last updated by the card network. Measured in seconds since the Unix epoch.
+      attr_reader :network_updated_at
+      # String representing the object's type. Objects of the same type share the same value.
+      attr_reader :object
+      # The usage state of the token.
+      attr_reader :status
+      # The digital wallet for this token, if one was used.
+      attr_reader :wallet_provider
+
       # Lists all Issuing Token objects for a given card.
       def self.list(filters = {}, opts = {})
         request_stripe_object(method: :get, path: "/v1/issuing/tokens", params: filters, opts: opts)

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

@@ -17,6 +17,112 @@ module Stripe
         "issuing.transaction"
       end
 
+      class AmountDetails < Stripe::StripeObject
+        attr_reader :atm_fee, :cashback_amount
+      end
+
+      class MerchantData < Stripe::StripeObject
+        attr_reader :category, :category_code, :city, :country, :name, :network_id, :postal_code, :state, :terminal_id, :url
+      end
+
+      class NetworkData < Stripe::StripeObject
+        attr_reader :authorization_code, :processing_date, :transaction_id
+      end
+
+      class PurchaseDetails < Stripe::StripeObject
+        class Fleet < Stripe::StripeObject
+          class CardholderPromptData < Stripe::StripeObject
+            attr_reader :driver_id, :odometer, :unspecified_id, :user_id, :vehicle_number
+          end
+
+          class ReportedBreakdown < Stripe::StripeObject
+            class Fuel < Stripe::StripeObject
+              attr_reader :gross_amount_decimal
+            end
+
+            class NonFuel < Stripe::StripeObject
+              attr_reader :gross_amount_decimal
+            end
+
+            class Tax < Stripe::StripeObject
+              attr_reader :local_amount_decimal, :national_amount_decimal
+            end
+            attr_reader :fuel, :non_fuel, :tax
+          end
+          attr_reader :cardholder_prompt_data, :purchase_type, :reported_breakdown, :service_type
+        end
+
+        class Flight < Stripe::StripeObject
+          class Segment < Stripe::StripeObject
+            attr_reader :arrival_airport_code, :carrier, :departure_airport_code, :flight_number, :service_class, :stopover_allowed
+          end
+          attr_reader :departure_at, :passenger_name, :refundable, :segments, :travel_agency
+        end
+
+        class Fuel < Stripe::StripeObject
+          attr_reader :industry_product_code, :quantity_decimal, :type, :unit, :unit_cost_decimal
+        end
+
+        class Lodging < Stripe::StripeObject
+          attr_reader :check_in_at, :nights
+        end
+
+        class Receipt < Stripe::StripeObject
+          attr_reader :description, :quantity, :total, :unit_cost
+        end
+        attr_reader :fleet, :flight, :fuel, :lodging, :receipt, :reference
+      end
+
+      class Treasury < Stripe::StripeObject
+        attr_reader :received_credit, :received_debit
+      end
+      # The transaction amount, which will be reflected in your balance. This amount is in your currency and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+      attr_reader :amount
+      # Detailed breakdown of amount components. These amounts are denominated in `currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+      attr_reader :amount_details
+      # The `Authorization` object that led to this transaction.
+      attr_reader :authorization
+      # ID of the [balance transaction](https://stripe.com/docs/api/balance_transactions) associated with this transaction.
+      attr_reader :balance_transaction
+      # The card used to make this transaction.
+      attr_reader :card
+      # The cardholder to whom this transaction belongs.
+      attr_reader :cardholder
+      # 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
+      # If you've disputed the transaction, the ID of the 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
+      # The amount that the merchant will receive, denominated in `merchant_currency` and in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). It will be different from `amount` if the merchant is taking payment in a different currency.
+      attr_reader :merchant_amount
+      # The currency with which the merchant is taking payment.
+      attr_reader :merchant_currency
+      # Attribute for field merchant_data
+      attr_reader :merchant_data
+      # 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 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
+      # Additional purchase information that is optionally provided by the merchant.
+      attr_reader :purchase_details
+      # Attribute for field settlement
+      attr_reader :settlement
+      # [Token](https://stripe.com/docs/api/issuing/tokens/object) object used for this transaction. If a network token was not used for this transaction, this field will be null.
+      attr_reader :token
+      # [Treasury](https://stripe.com/docs/api/treasury) details related to this transaction if it was created on a [FinancialAccount](/docs/api/treasury/financial_accounts
+      attr_reader :treasury
+      # The nature of the transaction.
+      attr_reader :type
+      # The digital wallet used for this transaction. One of `apple_pay`, `google_pay`, or `samsung_pay`.
+      attr_reader :wallet
+
       # Returns a list of Issuing Transaction objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
       def self.list(filters = {}, opts = {})
         request_stripe_object(

data/lib/stripe/resources/line_item.rb

@@ -8,5 +8,55 @@ module Stripe
     def self.object_name
       "item"
     end
+
+    class AdjustableQuantity < Stripe::StripeObject
+      attr_reader :enabled, :maximum, :minimum
+    end
+
+    class Discount < Stripe::StripeObject
+      attr_reader :amount, :discount
+    end
+
+    class Display < Stripe::StripeObject
+      attr_reader :description, :images, :name
+    end
+
+    class Tax < Stripe::StripeObject
+      attr_reader :amount, :rate, :taxability_reason, :taxable_amount
+    end
+    # Attribute for field adjustable_quantity
+    attr_reader :adjustable_quantity
+    # Total discount amount applied. If no discounts were applied, defaults to 0.
+    attr_reader :amount_discount
+    # Total before any discounts or taxes are applied.
+    attr_reader :amount_subtotal
+    # Total tax amount applied. If no tax was applied, defaults to 0.
+    attr_reader :amount_tax
+    # Total after discounts and taxes.
+    attr_reader :amount_total
+    # 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
+    # An arbitrary string attached to the object. Often useful for displaying to users. Defaults to product name.
+    attr_reader :description
+    # The discounts applied to the line item.
+    attr_reader :discounts
+    # Attribute for field display
+    attr_reader :display
+    # Unique identifier for the object.
+    attr_reader :id
+    # 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
+    # The price used to generate the line item.
+    attr_reader :price
+    # The ID of the product for this line item.
+    #
+    # This will always be the same as `price.product`.
+    attr_reader :product
+    # The quantity of products being purchased.
+    attr_reader :quantity
+    # The taxes applied to the line item.
+    attr_reader :taxes
   end
 end

data/lib/stripe/resources/login_link.rb

@@ -9,6 +9,13 @@ module Stripe
       "login_link"
     end
 
+    # Time at which the object was created. Measured in seconds since the Unix epoch.
+    attr_reader :created
+    # String representing the object's type. Objects of the same type share the same value.
+    attr_reader :object
+    # The URL for the login link.
+    attr_reader :url
+
     def self.retrieve(_id, _opts = nil)
       raise NotImplementedError,
             "Login links do not have IDs and cannot be retrieved. They can " \

data/lib/stripe/resources/mandate.rb

@@ -8,5 +8,83 @@ module Stripe
     def self.object_name
       "mandate"
     end
+
+    class CustomerAcceptance < Stripe::StripeObject
+      class Offline < Stripe::StripeObject; end
+
+      class Online < Stripe::StripeObject
+        attr_reader :ip_address, :user_agent
+      end
+      attr_reader :accepted_at, :offline, :online, :type
+    end
+
+    class MultiUse < Stripe::StripeObject; end
+
+    class PaymentMethodDetails < Stripe::StripeObject
+      class AcssDebit < Stripe::StripeObject
+        attr_reader :default_for, :interval_description, :payment_schedule, :transaction_type
+      end
+
+      class AmazonPay < Stripe::StripeObject; end
+
+      class AuBecsDebit < Stripe::StripeObject
+        attr_reader :url
+      end
+
+      class BacsDebit < Stripe::StripeObject
+        attr_reader :network_status, :reference, :revocation_reason, :url
+      end
+
+      class Card < Stripe::StripeObject; end
+      class Cashapp < Stripe::StripeObject; end
+      class KakaoPay < Stripe::StripeObject; end
+      class KrCard < Stripe::StripeObject; end
+      class Link < Stripe::StripeObject; end
+
+      class Paypal < Stripe::StripeObject
+        attr_reader :billing_agreement_id, :fingerprint, :payer_id, :verified_email
+      end
+
+      class Payto < Stripe::StripeObject
+        attr_reader :amount, :amount_type, :end_date, :payment_schedule, :payments_per_period, :purpose, :start_date
+      end
+
+      class RevolutPay < Stripe::StripeObject; end
+
+      class SepaDebit < Stripe::StripeObject
+        attr_reader :reference, :url
+      end
+
+      class UsBankAccount < Stripe::StripeObject
+        attr_reader :collection_method
+      end
+      attr_reader :acss_debit, :amazon_pay, :au_becs_debit, :bacs_debit, :card, :cashapp, :kakao_pay, :kr_card, :link, :paypal, :payto, :revolut_pay, :sepa_debit, :type, :us_bank_account
+    end
+
+    class SingleUse < Stripe::StripeObject
+      attr_reader :amount, :currency
+    end
+    # Attribute for field customer_acceptance
+    attr_reader :customer_acceptance
+    # 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 multi_use
+    attr_reader :multi_use
+    # String representing the object's type. Objects of the same type share the same value.
+    attr_reader :object
+    # The account (if any) that the mandate is intended for.
+    attr_reader :on_behalf_of
+    # ID of the payment method associated with this mandate.
+    attr_reader :payment_method
+    # Attribute for field payment_method_details
+    attr_reader :payment_method_details
+    # Attribute for field single_use
+    attr_reader :single_use
+    # The mandate status indicates whether or not you can use it to initiate a payment.
+    attr_reader :status
+    # The type of the mandate.
+    attr_reader :type
   end
 end

data/lib/stripe/resources/margin.rb

@@ -0,0 +1,56 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # A (partner) margin represents a specific discount distributed in partner reseller programs to business partners who
+  # resell products and services and earn a discount (margin) for doing so.
+  class Margin < APIResource
+    extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "margin"
+    def self.object_name
+      "margin"
+    end
+
+    # Whether the margin can be applied to invoices, invoice items, or invoice line items. Defaults to `true`.
+    attr_reader :active
+    # 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
+    # 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
+    # Name of the margin that's displayed on, for example, invoices.
+    attr_reader :name
+    # String representing the object's type. Objects of the same type share the same value.
+    attr_reader :object
+    # Percent that will be taken off the subtotal before tax (after all other discounts and promotions) of any invoice to which the margin is applied.
+    attr_reader :percent_off
+    # Time at which the object was last updated. Measured in seconds since the Unix epoch.
+    attr_reader :updated
+
+    # Create a margin object to be used with invoices, invoice items, and invoice line items for a customer to represent a partner discount. A margin has a percent_off which is the percent that will be taken off the subtotal after all items and other discounts and promotions) of any invoices for a customer. Calculation of prorations do not include any partner margins applied on the original invoice item.
+    def self.create(params = {}, opts = {})
+      request_stripe_object(method: :post, path: "/v1/billing/margins", params: params, opts: opts)
+    end
+
+    # Retrieve a list of your margins.
+    def self.list(filters = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/billing/margins", params: filters, opts: opts)
+    end
+
+    # Update the specified margin object. Certain fields of the margin object are not editable.
+    def self.update(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/billing/margins/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
+  end
+end