stripe 17.0.0 → 17.1.0.pre.alpha.1

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

@@ -17,7 +17,7 @@ module Stripe
         "issuing.transaction"
       end
 
-      class AmountDetails < Stripe::StripeObject
+      class AmountDetails < ::Stripe::StripeObject
         # The fee charged by the ATM for the cash withdrawal.
         attr_reader :atm_fee
         # The amount of cash requested by the cardholder.
@@ -32,7 +32,7 @@ module Stripe
         end
       end
 
-      class MerchantData < Stripe::StripeObject
+      class MerchantData < ::Stripe::StripeObject
         # A categorization of the seller's type of business. See our [merchant categories guide](https://stripe.com/docs/issuing/merchant-categories) for a list of possible values.
         attr_reader :category
         # The merchant category code for the seller’s business
@@ -65,7 +65,7 @@ module Stripe
         end
       end
 
-      class NetworkData < Stripe::StripeObject
+      class NetworkData < ::Stripe::StripeObject
         # A code created by Stripe which is shared with the merchant to validate the authorization. This field will be populated if the authorization message was approved. The code typically starts with the letter "S", followed by a six-digit number. For example, "S498162". Please note that the code is not guaranteed to be unique across authorizations.
         attr_reader :authorization_code
         # 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.
@@ -82,9 +82,9 @@ module Stripe
         end
       end
 
-      class PurchaseDetails < Stripe::StripeObject
-        class Fleet < Stripe::StripeObject
-          class CardholderPromptData < Stripe::StripeObject
+      class PurchaseDetails < ::Stripe::StripeObject
+        class Fleet < ::Stripe::StripeObject
+          class CardholderPromptData < ::Stripe::StripeObject
             # Driver ID.
             attr_reader :driver_id
             # Odometer reading.
@@ -105,8 +105,8 @@ module Stripe
             end
           end
 
-          class ReportedBreakdown < Stripe::StripeObject
-            class Fuel < Stripe::StripeObject
+          class ReportedBreakdown < ::Stripe::StripeObject
+            class Fuel < ::Stripe::StripeObject
               # Gross fuel amount that should equal Fuel Volume multipled by Fuel Unit Cost, inclusive of taxes.
               attr_reader :gross_amount_decimal
 
@@ -119,7 +119,7 @@ module Stripe
               end
             end
 
-            class NonFuel < Stripe::StripeObject
+            class NonFuel < ::Stripe::StripeObject
               # Gross non-fuel amount that should equal the sum of the line items, inclusive of taxes.
               attr_reader :gross_amount_decimal
 
@@ -132,7 +132,7 @@ module Stripe
               end
             end
 
-            class Tax < Stripe::StripeObject
+            class Tax < ::Stripe::StripeObject
               # Amount of state or provincial Sales Tax included in the transaction amount. Null if not reported by merchant or not subject to tax.
               attr_reader :local_amount_decimal
               # Amount of national Sales Tax or VAT included in the transaction amount. Null if not reported by merchant or not subject to tax.
@@ -182,8 +182,8 @@ module Stripe
           end
         end
 
-        class Flight < Stripe::StripeObject
-          class Segment < Stripe::StripeObject
+        class Flight < ::Stripe::StripeObject
+          class Segment < ::Stripe::StripeObject
             # The three-letter IATA airport code of the flight's destination.
             attr_reader :arrival_airport_code
             # The airline carrier code.
@@ -225,7 +225,7 @@ module Stripe
           end
         end
 
-        class Fuel < Stripe::StripeObject
+        class Fuel < ::Stripe::StripeObject
           # [Conexxus Payment System Product Code](https://www.conexxus.org/conexxus-payment-system-product-codes) identifying the primary fuel product purchased.
           attr_reader :industry_product_code
           # The quantity of `unit`s of fuel that was dispensed, represented as a decimal string with at most 12 decimal places.
@@ -246,7 +246,7 @@ module Stripe
           end
         end
 
-        class Lodging < Stripe::StripeObject
+        class Lodging < ::Stripe::StripeObject
           # The time of checking into the lodging.
           attr_reader :check_in_at
           # The number of nights stayed at the lodging.
@@ -261,7 +261,7 @@ module Stripe
           end
         end
 
-        class Receipt < Stripe::StripeObject
+        class Receipt < ::Stripe::StripeObject
           # The description of the item. The maximum length of this field is 26 characters.
           attr_reader :description
           # The quantity of the item.
@@ -307,7 +307,7 @@ module Stripe
         end
       end
 
-      class Treasury < Stripe::StripeObject
+      class Treasury < ::Stripe::StripeObject
         # The Treasury [ReceivedCredit](https://stripe.com/docs/api/treasury/received_credits) representing this Issuing transaction if it is a refund
         attr_reader :received_credit
         # The Treasury [ReceivedDebit](https://stripe.com/docs/api/treasury/received_debits) representing this Issuing transaction if it is a capture
@@ -357,6 +357,8 @@ module Stripe
       attr_reader :object
       # Additional purchase information that is optionally provided by the merchant.
       attr_reader :purchase_details
+      # The ID of the [settlement](https://stripe.com/docs/api/issuing/settlements) to which this transaction belongs.
+      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

data/lib/stripe/resources/line_item.rb

@@ -9,7 +9,24 @@ module Stripe
       "item"
     end
 
-    class Discount < Stripe::StripeObject
+    class AdjustableQuantity < ::Stripe::StripeObject
+      # Attribute for field enabled
+      attr_reader :enabled
+      # Attribute for field maximum
+      attr_reader :maximum
+      # Attribute for field minimum
+      attr_reader :minimum
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+
+    class Discount < ::Stripe::StripeObject
       # The amount discounted.
       attr_reader :amount
       # A discount represents the actual application of a [coupon](https://stripe.com/docs/api#coupons) or [promotion code](https://stripe.com/docs/api#promotion_codes).
@@ -27,7 +44,39 @@ module Stripe
       end
     end
 
-    class Tax < Stripe::StripeObject
+    class Display < ::Stripe::StripeObject
+      # Attribute for field description
+      attr_reader :description
+      # Attribute for field images
+      attr_reader :images
+      # Attribute for field name
+      attr_reader :name
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+
+    class TaxCalculationReference < ::Stripe::StripeObject
+      # The calculation identifier for tax calculation response.
+      attr_reader :calculation_id
+      # The calculation identifier for tax calculation response line item.
+      attr_reader :calculation_item_id
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+
+    class Tax < ::Stripe::StripeObject
       # Amount of tax applied for this rate.
       attr_reader :amount
       # Tax rates can be applied to [invoices](/invoicing/taxes/tax-rates), [subscriptions](/billing/taxes/tax-rates) and [Checkout Sessions](/payments/checkout/use-manual-tax-rates) to collect tax.
@@ -47,6 +96,8 @@ module Stripe
         @field_remappings = {}
       end
     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.
@@ -61,19 +112,35 @@ module Stripe
     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 tax calculation identifiers of the line item.
+    attr_reader :tax_calculation_reference
     # The taxes applied to the line item.
     attr_reader :taxes
 
     def self.inner_class_types
-      @inner_class_types = { discounts: Discount, taxes: Tax }
+      @inner_class_types = {
+        adjustable_quantity: AdjustableQuantity,
+        discounts: Discount,
+        display: Display,
+        tax_calculation_reference: TaxCalculationReference,
+        taxes: Tax,
+      }
     end
 
     def self.field_remappings

data/lib/stripe/resources/mandate.rb

@@ -4,13 +4,15 @@
 module Stripe
   # A Mandate is a record of the permission that your customer gives you to debit their payment method.
   class Mandate < APIResource
+    extend Stripe::APIOperations::List
+
     OBJECT_NAME = "mandate"
     def self.object_name
       "mandate"
     end
 
-    class CustomerAcceptance < Stripe::StripeObject
-      class Offline < Stripe::StripeObject
+    class CustomerAcceptance < ::Stripe::StripeObject
+      class Offline < ::Stripe::StripeObject
         def self.inner_class_types
           @inner_class_types = {}
         end
@@ -20,7 +22,7 @@ module Stripe
         end
       end
 
-      class Online < Stripe::StripeObject
+      class Online < ::Stripe::StripeObject
         # The customer accepts the mandate from this IP address.
         attr_reader :ip_address
         # The customer accepts the mandate using the user agent of the browser.
@@ -52,7 +54,12 @@ module Stripe
       end
     end
 
-    class MultiUse < Stripe::StripeObject
+    class MultiUse < ::Stripe::StripeObject
+      # The amount of the payment on a multi use mandate.
+      attr_reader :amount
+      # The currency of the payment on a multi use mandate.
+      attr_reader :currency
+
       def self.inner_class_types
         @inner_class_types = {}
       end
@@ -62,8 +69,8 @@ module Stripe
       end
     end
 
-    class PaymentMethodDetails < Stripe::StripeObject
-      class AcssDebit < Stripe::StripeObject
+    class PaymentMethodDetails < ::Stripe::StripeObject
+      class AcssDebit < ::Stripe::StripeObject
         # List of Stripe products where this mandate can be selected automatically.
         attr_reader :default_for
         # Description of the interval. Only required if the 'payment_schedule' parameter is 'interval' or 'combined'.
@@ -82,7 +89,7 @@ module Stripe
         end
       end
 
-      class AmazonPay < Stripe::StripeObject
+      class AmazonPay < ::Stripe::StripeObject
         def self.inner_class_types
           @inner_class_types = {}
         end
@@ -92,7 +99,7 @@ module Stripe
         end
       end
 
-      class AuBecsDebit < Stripe::StripeObject
+      class AuBecsDebit < ::Stripe::StripeObject
         # The URL of the mandate. This URL generally contains sensitive information about the customer and should be shared with them exclusively.
         attr_reader :url
 
@@ -105,7 +112,7 @@ module Stripe
         end
       end
 
-      class BacsDebit < Stripe::StripeObject
+      class BacsDebit < ::Stripe::StripeObject
         # The status of the mandate on the Bacs network. Can be one of `pending`, `revoked`, `refused`, or `accepted`.
         attr_reader :network_status
         # The unique reference identifying the mandate on the Bacs network.
@@ -124,7 +131,7 @@ module Stripe
         end
       end
 
-      class Card < Stripe::StripeObject
+      class Card < ::Stripe::StripeObject
         def self.inner_class_types
           @inner_class_types = {}
         end
@@ -134,7 +141,7 @@ module Stripe
         end
       end
 
-      class Cashapp < Stripe::StripeObject
+      class Cashapp < ::Stripe::StripeObject
         def self.inner_class_types
           @inner_class_types = {}
         end
@@ -144,7 +151,7 @@ module Stripe
         end
       end
 
-      class KakaoPay < Stripe::StripeObject
+      class KakaoPay < ::Stripe::StripeObject
         def self.inner_class_types
           @inner_class_types = {}
         end
@@ -154,7 +161,7 @@ module Stripe
         end
       end
 
-      class Klarna < Stripe::StripeObject
+      class Klarna < ::Stripe::StripeObject
         def self.inner_class_types
           @inner_class_types = {}
         end
@@ -164,7 +171,7 @@ module Stripe
         end
       end
 
-      class KrCard < Stripe::StripeObject
+      class KrCard < ::Stripe::StripeObject
         def self.inner_class_types
           @inner_class_types = {}
         end
@@ -174,7 +181,7 @@ module Stripe
         end
       end
 
-      class Link < Stripe::StripeObject
+      class Link < ::Stripe::StripeObject
         def self.inner_class_types
           @inner_class_types = {}
         end
@@ -184,7 +191,7 @@ module Stripe
         end
       end
 
-      class NaverPay < Stripe::StripeObject
+      class NaverPay < ::Stripe::StripeObject
         def self.inner_class_types
           @inner_class_types = {}
         end
@@ -194,7 +201,7 @@ module Stripe
         end
       end
 
-      class NzBankAccount < Stripe::StripeObject
+      class NzBankAccount < ::Stripe::StripeObject
         def self.inner_class_types
           @inner_class_types = {}
         end
@@ -204,11 +211,16 @@ module Stripe
         end
       end
 
-      class Paypal < Stripe::StripeObject
+      class Paypal < ::Stripe::StripeObject
         # The PayPal Billing Agreement ID (BAID). This is an ID generated by PayPal which represents the mandate between the merchant and the customer.
         attr_reader :billing_agreement_id
+        # Uniquely identifies this particular PayPal account. You can use this attribute to check whether two PayPal accounts are the same.
+        attr_reader :fingerprint
         # PayPal account PayerID. This identifier uniquely identifies the PayPal customer.
         attr_reader :payer_id
+        # Owner's verified email. Values are verified or provided by PayPal directly
+        # (if supported) at the time of authorization or settlement. They cannot be set or mutated.
+        attr_reader :verified_email
 
         def self.inner_class_types
           @inner_class_types = {}
@@ -219,7 +231,22 @@ module Stripe
         end
       end
 
-      class RevolutPay < Stripe::StripeObject
+      class Payto < ::Stripe::StripeObject
+        # Amount that will be collected. It is required when `amount_type` is `fixed`.
+        attr_reader :amount
+        # The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.
+        attr_reader :amount_type
+        # Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date.
+        attr_reader :end_date
+        # The periodicity at which payments will be collected.
+        attr_reader :payment_schedule
+        # The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit.
+        attr_reader :payments_per_period
+        # The purpose for which payments are made. Defaults to retail.
+        attr_reader :purpose
+        # Date, in YYYY-MM-DD format, from which payments will be collected. Defaults to confirmation time.
+        attr_reader :start_date
+
         def self.inner_class_types
           @inner_class_types = {}
         end
@@ -229,7 +256,40 @@ module Stripe
         end
       end
 
-      class SepaDebit < Stripe::StripeObject
+      class Pix < ::Stripe::StripeObject
+        # Determines if the amount includes the IOF tax.
+        attr_reader :amount_includes_iof
+        # Type of amount.
+        attr_reader :amount_type
+        # Date when the mandate expires and no further payments will be charged, in `YYYY-MM-DD`.
+        attr_reader :end_date
+        # Schedule at which the future payments will be charged.
+        attr_reader :payment_schedule
+        # Subscription name displayed to buyers in their bank app.
+        attr_reader :reference
+        # Start date of the mandate, in `YYYY-MM-DD`.
+        attr_reader :start_date
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class RevolutPay < ::Stripe::StripeObject
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class SepaDebit < ::Stripe::StripeObject
         # The unique reference of the mandate.
         attr_reader :reference
         # The URL of the mandate. This URL generally contains sensitive information about the customer and should be shared with them exclusively.
@@ -244,7 +304,7 @@ module Stripe
         end
       end
 
-      class UsBankAccount < Stripe::StripeObject
+      class UsBankAccount < ::Stripe::StripeObject
         # Mandate collection method
         attr_reader :collection_method
 
@@ -282,6 +342,10 @@ module Stripe
       attr_reader :nz_bank_account
       # Attribute for field paypal
       attr_reader :paypal
+      # Attribute for field payto
+      attr_reader :payto
+      # Attribute for field pix
+      attr_reader :pix
       # Attribute for field revolut_pay
       attr_reader :revolut_pay
       # Attribute for field sepa_debit
@@ -306,6 +370,8 @@ module Stripe
           naver_pay: NaverPay,
           nz_bank_account: NzBankAccount,
           paypal: Paypal,
+          payto: Payto,
+          pix: Pix,
           revolut_pay: RevolutPay,
           sepa_debit: SepaDebit,
           us_bank_account: UsBankAccount,
@@ -317,7 +383,7 @@ module Stripe
       end
     end
 
-    class SingleUse < Stripe::StripeObject
+    class SingleUse < ::Stripe::StripeObject
       # The amount of the payment on a single use mandate.
       attr_reader :amount
       # The currency of the payment on a single use mandate.
@@ -354,6 +420,11 @@ module Stripe
     # The type of the mandate.
     attr_reader :type
 
+    # Retrieves a list of Mandates for a given PaymentMethod.
+    def self.list(params = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/mandates", params: params, opts: opts)
+    end
+
     def self.inner_class_types
       @inner_class_types = {
         customer_acceptance: CustomerAcceptance,

data/lib/stripe/resources/margin.rb

@@ -0,0 +1,64 @@
+# 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(params = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/billing/margins", params: params, opts: opts)
+    end
+
+    # Update the specified margin object. Certain fields of the margin object are not editable.
+    def self.update(margin, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/billing/margins/%<margin>s", { margin: CGI.escape(margin) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.inner_class_types
+      @inner_class_types = {}
+    end
+
+    def self.field_remappings
+      @field_remappings = {}
+    end
+  end
+end