stripe 15.5.0.pre.beta.2 → 15.6.0.pre.alpha.1

data/lib/stripe/resources/payment_intent.rb

@@ -95,7 +95,7 @@ module Stripe
       attr_reader :message
       # For card errors resulting from a card issuer decline, a 2 digit code which indicates the advice given to merchant by the card network on how to proceed with an error.
       attr_reader :network_advice_code
-      # For card errors resulting from a card issuer decline, a brand specific 2, 3, or 4 digit code which indicates the reason the authorization failed.
+      # For payments declined by the network, an alphanumeric code which indicates the reason the payment failed.
       attr_reader :network_decline_code
       # If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
       attr_reader :param
@@ -1600,10 +1600,32 @@ module Stripe
       end
 
       class Pix < Stripe::StripeObject
+        class MandateOptions < Stripe::StripeObject
+          # Amount to be charged for future payments.
+          attr_reader :amount
+          # Determines if the amount includes the IOF tax.
+          attr_reader :amount_includes_iof
+          # Type of amount.
+          attr_reader :amount_type
+          # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase.
+          attr_reader :currency
+          # 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
+        end
+        # Determines if the amount includes the IOF tax.
+        attr_reader :amount_includes_iof
         # The number of seconds (between 10 and 1209600) after which Pix payment will expire.
         attr_reader :expires_after_seconds
         # The timestamp at which the Pix expires.
         attr_reader :expires_at
+        # Attribute for field mandate_options
+        attr_reader :mandate_options
         # Indicates that you intend to make future payments with this PaymentIntent's payment method.
         #
         # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
@@ -4942,10 +4964,52 @@ module Stripe
         end
 
         class Pix < Stripe::RequestParams
+          class MandateOptions < Stripe::RequestParams
+            # Amount to be charged for future payments. Required when `amount_type=fixed`. If not provided for `amount_type=maximum`, defaults to 40000.
+            attr_accessor :amount
+            # Determines if the amount includes the IOF tax. Defaults to `never`.
+            attr_accessor :amount_includes_iof
+            # Type of amount. Defaults to `maximum`.
+            attr_accessor :amount_type
+            # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Only `brl` is supported currently.
+            attr_accessor :currency
+            # Date when the mandate expires and no further payments will be charged, in `YYYY-MM-DD`. If not provided, the mandate will be active until canceled. If provided, end date should be after start date.
+            attr_accessor :end_date
+            # Schedule at which the future payments will be charged. Defaults to `weekly`.
+            attr_accessor :payment_schedule
+            # Subscription name displayed to buyers in their bank app. Defaults to the displayable business name.
+            attr_accessor :reference
+            # Start date of the mandate, in `YYYY-MM-DD`. Start date should be at least 3 days in the future. Defaults to 3 days after the current date.
+            attr_accessor :start_date
+
+            def initialize(
+              amount: nil,
+              amount_includes_iof: nil,
+              amount_type: nil,
+              currency: nil,
+              end_date: nil,
+              payment_schedule: nil,
+              reference: nil,
+              start_date: nil
+            )
+              @amount = amount
+              @amount_includes_iof = amount_includes_iof
+              @amount_type = amount_type
+              @currency = currency
+              @end_date = end_date
+              @payment_schedule = payment_schedule
+              @reference = reference
+              @start_date = start_date
+            end
+          end
+          # Determines if the amount includes the IOF tax. Defaults to `never`.
+          attr_accessor :amount_includes_iof
           # The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
           attr_accessor :expires_after_seconds
           # The timestamp at which the Pix expires (between 10 and 1209600 seconds in the future). Defaults to 1 day in the future.
           attr_accessor :expires_at
+          # Additional fields for mandate creation. Only applicable when `setup_future_usage=off_session`.
+          attr_accessor :mandate_options
           # Indicates that you intend to make future payments with this PaymentIntent's payment method.
           #
           # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
@@ -4957,9 +5021,17 @@ module Stripe
           # If you've already set `setup_future_usage` and you're performing a request using a publishable key, you can only update the value from `on_session` to `off_session`.
           attr_accessor :setup_future_usage
 
-          def initialize(expires_after_seconds: nil, expires_at: nil, setup_future_usage: nil)
+          def initialize(
+            amount_includes_iof: nil,
+            expires_after_seconds: nil,
+            expires_at: nil,
+            mandate_options: nil,
+            setup_future_usage: nil
+          )
+            @amount_includes_iof = amount_includes_iof
             @expires_after_seconds = expires_after_seconds
             @expires_at = expires_at
+            @mandate_options = mandate_options
             @setup_future_usage = setup_future_usage
           end
         end
@@ -5670,6 +5742,8 @@ module Stripe
       attr_accessor :description
       # Set to `true` to fail the payment attempt if the PaymentIntent transitions into `requires_action`. Use this parameter for simpler integrations that don't handle customer actions, such as [saving cards without authentication](https://stripe.com/docs/payments/save-card-without-authentication). This parameter can only be used with [`confirm=true`](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-confirm).
       attr_accessor :error_on_requires_action
+      # The list of payment method types to exclude from use with this payment.
+      attr_accessor :excluded_payment_method_types
       # Specifies which fields in the response should be expanded.
       attr_accessor :expand
       # The FX rate in the quote is validated and used to convert the presentment amount to the settlement amount.
@@ -5750,6 +5824,7 @@ module Stripe
         customer_account: nil,
         description: nil,
         error_on_requires_action: nil,
+        excluded_payment_method_types: nil,
         expand: nil,
         fx_quote: nil,
         hooks: nil,
@@ -5789,6 +5864,7 @@ module Stripe
         @customer_account = customer_account
         @description = description
         @error_on_requires_action = error_on_requires_action
+        @excluded_payment_method_types = excluded_payment_method_types
         @expand = expand
         @fx_quote = fx_quote
         @hooks = hooks
@@ -8694,10 +8770,52 @@ module Stripe
         end
 
         class Pix < Stripe::RequestParams
+          class MandateOptions < Stripe::RequestParams
+            # Amount to be charged for future payments. Required when `amount_type=fixed`. If not provided for `amount_type=maximum`, defaults to 40000.
+            attr_accessor :amount
+            # Determines if the amount includes the IOF tax. Defaults to `never`.
+            attr_accessor :amount_includes_iof
+            # Type of amount. Defaults to `maximum`.
+            attr_accessor :amount_type
+            # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Only `brl` is supported currently.
+            attr_accessor :currency
+            # Date when the mandate expires and no further payments will be charged, in `YYYY-MM-DD`. If not provided, the mandate will be active until canceled. If provided, end date should be after start date.
+            attr_accessor :end_date
+            # Schedule at which the future payments will be charged. Defaults to `weekly`.
+            attr_accessor :payment_schedule
+            # Subscription name displayed to buyers in their bank app. Defaults to the displayable business name.
+            attr_accessor :reference
+            # Start date of the mandate, in `YYYY-MM-DD`. Start date should be at least 3 days in the future. Defaults to 3 days after the current date.
+            attr_accessor :start_date
+
+            def initialize(
+              amount: nil,
+              amount_includes_iof: nil,
+              amount_type: nil,
+              currency: nil,
+              end_date: nil,
+              payment_schedule: nil,
+              reference: nil,
+              start_date: nil
+            )
+              @amount = amount
+              @amount_includes_iof = amount_includes_iof
+              @amount_type = amount_type
+              @currency = currency
+              @end_date = end_date
+              @payment_schedule = payment_schedule
+              @reference = reference
+              @start_date = start_date
+            end
+          end
+          # Determines if the amount includes the IOF tax. Defaults to `never`.
+          attr_accessor :amount_includes_iof
           # The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
           attr_accessor :expires_after_seconds
           # The timestamp at which the Pix expires (between 10 and 1209600 seconds in the future). Defaults to 1 day in the future.
           attr_accessor :expires_at
+          # Additional fields for mandate creation. Only applicable when `setup_future_usage=off_session`.
+          attr_accessor :mandate_options
           # Indicates that you intend to make future payments with this PaymentIntent's payment method.
           #
           # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
@@ -8709,9 +8827,17 @@ module Stripe
           # If you've already set `setup_future_usage` and you're performing a request using a publishable key, you can only update the value from `on_session` to `off_session`.
           attr_accessor :setup_future_usage
 
-          def initialize(expires_after_seconds: nil, expires_at: nil, setup_future_usage: nil)
+          def initialize(
+            amount_includes_iof: nil,
+            expires_after_seconds: nil,
+            expires_at: nil,
+            mandate_options: nil,
+            setup_future_usage: nil
+          )
+            @amount_includes_iof = amount_includes_iof
             @expires_after_seconds = expires_after_seconds
             @expires_at = expires_at
+            @mandate_options = mandate_options
             @setup_future_usage = setup_future_usage
           end
         end
@@ -13374,10 +13500,52 @@ module Stripe
         end
 
         class Pix < Stripe::RequestParams
+          class MandateOptions < Stripe::RequestParams
+            # Amount to be charged for future payments. Required when `amount_type=fixed`. If not provided for `amount_type=maximum`, defaults to 40000.
+            attr_accessor :amount
+            # Determines if the amount includes the IOF tax. Defaults to `never`.
+            attr_accessor :amount_includes_iof
+            # Type of amount. Defaults to `maximum`.
+            attr_accessor :amount_type
+            # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Only `brl` is supported currently.
+            attr_accessor :currency
+            # Date when the mandate expires and no further payments will be charged, in `YYYY-MM-DD`. If not provided, the mandate will be active until canceled. If provided, end date should be after start date.
+            attr_accessor :end_date
+            # Schedule at which the future payments will be charged. Defaults to `weekly`.
+            attr_accessor :payment_schedule
+            # Subscription name displayed to buyers in their bank app. Defaults to the displayable business name.
+            attr_accessor :reference
+            # Start date of the mandate, in `YYYY-MM-DD`. Start date should be at least 3 days in the future. Defaults to 3 days after the current date.
+            attr_accessor :start_date
+
+            def initialize(
+              amount: nil,
+              amount_includes_iof: nil,
+              amount_type: nil,
+              currency: nil,
+              end_date: nil,
+              payment_schedule: nil,
+              reference: nil,
+              start_date: nil
+            )
+              @amount = amount
+              @amount_includes_iof = amount_includes_iof
+              @amount_type = amount_type
+              @currency = currency
+              @end_date = end_date
+              @payment_schedule = payment_schedule
+              @reference = reference
+              @start_date = start_date
+            end
+          end
+          # Determines if the amount includes the IOF tax. Defaults to `never`.
+          attr_accessor :amount_includes_iof
           # The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
           attr_accessor :expires_after_seconds
           # The timestamp at which the Pix expires (between 10 and 1209600 seconds in the future). Defaults to 1 day in the future.
           attr_accessor :expires_at
+          # Additional fields for mandate creation. Only applicable when `setup_future_usage=off_session`.
+          attr_accessor :mandate_options
           # Indicates that you intend to make future payments with this PaymentIntent's payment method.
           #
           # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
@@ -13389,9 +13557,17 @@ module Stripe
           # If you've already set `setup_future_usage` and you're performing a request using a publishable key, you can only update the value from `on_session` to `off_session`.
           attr_accessor :setup_future_usage
 
-          def initialize(expires_after_seconds: nil, expires_at: nil, setup_future_usage: nil)
+          def initialize(
+            amount_includes_iof: nil,
+            expires_after_seconds: nil,
+            expires_at: nil,
+            mandate_options: nil,
+            setup_future_usage: nil
+          )
+            @amount_includes_iof = amount_includes_iof
             @expires_after_seconds = expires_after_seconds
             @expires_at = expires_at
+            @mandate_options = mandate_options
             @setup_future_usage = setup_future_usage
           end
         end
@@ -14573,6 +14749,8 @@ module Stripe
     attr_reader :customer_account
     # An arbitrary string attached to the object. Often useful for displaying to users.
     attr_reader :description
+    # The list of payment method types to exclude from use with this payment.
+    attr_reader :excluded_payment_method_types
     # The FX Quote used for the PaymentIntent.
     attr_reader :fx_quote
     # Attribute for field hooks

data/lib/stripe/resources/payment_link.rb

@@ -726,7 +726,7 @@ module Stripe
         end
         # When set, provides configuration for this item’s quantity to be adjusted by the customer during checkout.
         attr_accessor :adjustable_quantity
-        # The ID of the [Price](https://stripe.com/docs/api/prices) or [Plan](https://stripe.com/docs/api/plans) object.
+        # The ID of the [Price](https://stripe.com/docs/api/prices) or [Plan](https://stripe.com/docs/api/plans) object. One of `price` or `price_data` is required.
         attr_accessor :price
         # Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required.
         attr_accessor :price_data

data/lib/stripe/resources/payment_method.rb

@@ -1640,6 +1640,8 @@ module Stripe
     attr_reader :konbini
     # Attribute for field kr_card
     attr_reader :kr_card
+    # The Mandate object of the most recently created Mandate associated with this payment method
+    attr_reader :latest_active_mandate
     # Attribute for field link
     attr_reader :link
     # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

data/lib/stripe/resources/payment_record.rb

@@ -12,31 +12,52 @@ module Stripe
       "payment_record"
     end
 
+    class Amount < Stripe::StripeObject
+      # 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
+      # A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY.
+      attr_reader :value
+    end
+
+    class AmountAuthorized < Stripe::StripeObject
+      # 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
+      # A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY.
+      attr_reader :value
+    end
+
     class AmountCanceled < Stripe::StripeObject
       # 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
-      # A positive integer representing the amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) for example, 100 cents for 1 USD or 100 for 100 JPY, a zero-decimal currency.
+      # A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY.
       attr_reader :value
     end
 
     class AmountFailed < Stripe::StripeObject
       # 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
-      # A positive integer representing the amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) for example, 100 cents for 1 USD or 100 for 100 JPY, a zero-decimal currency.
+      # A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY.
       attr_reader :value
     end
 
     class AmountGuaranteed < Stripe::StripeObject
       # 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
-      # A positive integer representing the amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) for example, 100 cents for 1 USD or 100 for 100 JPY, a zero-decimal currency.
+      # A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY.
+      attr_reader :value
+    end
+
+    class AmountRefunded < Stripe::StripeObject
+      # 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
+      # A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY.
       attr_reader :value
     end
 
     class AmountRequested < Stripe::StripeObject
       # 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
-      # A positive integer representing the amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) for example, 100 cents for 1 USD or 100 for 100 JPY, a zero-decimal currency.
+      # A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY.
       attr_reader :value
     end
 
@@ -118,7 +139,16 @@ module Stripe
         attr_reader :transaction_id
       end
 
-      class Alma < Stripe::StripeObject; end
+      class Alma < Stripe::StripeObject
+        class Installments < Stripe::StripeObject
+          # The number of installments.
+          attr_reader :count
+        end
+        # Attribute for field installments
+        attr_reader :installments
+        # The Alma transaction ID associated with this payment.
+        attr_reader :transaction_id
+      end
 
       class AmazonPay < Stripe::StripeObject
         class Funding < Stripe::StripeObject
@@ -145,6 +175,8 @@ module Stripe
         end
         # Attribute for field funding
         attr_reader :funding
+        # The Amazon Pay transaction ID associated with this payment.
+        attr_reader :transaction_id
       end
 
       class AuBecsDebit < Stripe::StripeObject
@@ -190,7 +222,10 @@ module Stripe
         attr_reader :verified_name
       end
 
-      class Billie < Stripe::StripeObject; end
+      class Billie < Stripe::StripeObject
+        # The Billie transaction ID associated with this payment.
+        attr_reader :transaction_id
+      end
 
       class BillingDetails < Stripe::StripeObject
         class Address < Stripe::StripeObject
@@ -531,6 +566,8 @@ module Stripe
       class KakaoPay < Stripe::StripeObject
         # A unique identifier for the buyer as determined by the local payment processor.
         attr_reader :buyer_id
+        # The Kakao Pay transaction ID associated with this payment.
+        attr_reader :transaction_id
       end
 
       class Klarna < Stripe::StripeObject
@@ -568,6 +605,8 @@ module Stripe
         attr_reader :buyer_id
         # The last four digits of the card. This may not be present for American Express cards.
         attr_reader :last4
+        # The Korean Card transaction ID associated with this payment.
+        attr_reader :transaction_id
       end
 
       class Link < Stripe::StripeObject
@@ -605,6 +644,8 @@ module Stripe
       class NaverPay < Stripe::StripeObject
         # A unique identifier for the buyer as determined by the local payment processor.
         attr_reader :buyer_id
+        # The Naver Pay transaction ID associated with this payment.
+        attr_reader :transaction_id
       end
 
       class NzBankAccount < Stripe::StripeObject
@@ -643,6 +684,8 @@ module Stripe
       class Payco < Stripe::StripeObject
         # A unique identifier for the buyer as determined by the local payment processor.
         attr_reader :buyer_id
+        # The Payco transaction ID associated with this payment.
+        attr_reader :transaction_id
       end
 
       class Paynow < Stripe::StripeObject
@@ -731,6 +774,8 @@ module Stripe
       class Pix < Stripe::StripeObject
         # Unique transaction id generated by BCB
         attr_reader :bank_transaction_id
+        # ID of the multi use Mandate generated by the PaymentIntent
+        attr_reader :mandate
       end
 
       class Promptpay < Stripe::StripeObject
@@ -766,14 +811,21 @@ module Stripe
         end
         # Attribute for field funding
         attr_reader :funding
+        # The Revolut Pay transaction ID associated with this payment.
+        attr_reader :transaction_id
       end
 
       class SamsungPay < Stripe::StripeObject
         # A unique identifier for the buyer as determined by the local payment processor.
         attr_reader :buyer_id
+        # The Samsung Pay transaction ID associated with this payment.
+        attr_reader :transaction_id
       end
 
-      class Satispay < Stripe::StripeObject; end
+      class Satispay < Stripe::StripeObject
+        # The Satispay transaction ID associated with this payment.
+        attr_reader :transaction_id
+      end
 
       class SepaCreditTransfer < Stripe::StripeObject
         # Name of the bank associated with the bank account.
@@ -1017,6 +1069,19 @@ module Stripe
       attr_reader :zip
     end
 
+    class ProcessorDetails < Stripe::StripeObject
+      class Custom < Stripe::StripeObject
+        # An opaque string for manual reconciliation of this payment, for example a check number or a payment processor ID.
+        attr_reader :payment_reference
+      end
+      # Custom processors represent payment processors not modeled directly in
+      # the Stripe API. This resource consists of details about the custom processor
+      # used for this payment attempt.
+      attr_reader :custom
+      # The processor used for this payment attempt.
+      attr_reader :type
+    end
+
     class ShippingDetails < Stripe::StripeObject
       class Address < Stripe::StripeObject
         # City, district, suburb, town, or village.
@@ -1271,7 +1336,7 @@ module Stripe
       class AmountRequested < Stripe::RequestParams
         # 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_accessor :currency
-        # A positive integer representing the amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) for example, 100 cents for 1 USD or 100 for 100 JPY, a zero-decimal currency.
+        # A positive integer representing the amount in the currency's [minor unit](https://stripe.com/docs/currencies#zero-decimal). For example, `100` can represent 1 USD or 100 JPY.
         attr_accessor :value
 
         def initialize(currency: nil, value: nil)
@@ -1393,6 +1458,26 @@ module Stripe
         end
       end
 
+      class ProcessorDetails < Stripe::RequestParams
+        class Custom < Stripe::RequestParams
+          # An opaque string for manual reconciliation of this payment, for example a check number or a payment processor ID.
+          attr_accessor :payment_reference
+
+          def initialize(payment_reference: nil)
+            @payment_reference = payment_reference
+          end
+        end
+        # Information about the custom processor used to make this payment.
+        attr_accessor :custom
+        # The type of the processor details. An additional hash is included on processor_details with a name matching this value. It contains additional information specific to the processor.
+        attr_accessor :type
+
+        def initialize(custom: nil, type: nil)
+          @custom = custom
+          @type = type
+        end
+      end
+
       class ShippingDetails < Stripe::RequestParams
         class Address < Stripe::RequestParams
           # City, district, suburb, town, or village.
@@ -1459,8 +1544,8 @@ module Stripe
       attr_accessor :outcome
       # Information about the Payment Method debited for this payment.
       attr_accessor :payment_method_details
-      # An opaque string for manual reconciliation of this payment, for example a check number or a payment processor ID.
-      attr_accessor :payment_reference
+      # Processor information for this payment.
+      attr_accessor :processor_details
       # Shipping information for this payment.
       attr_accessor :shipping_details
 
@@ -1476,7 +1561,7 @@ module Stripe
         metadata: nil,
         outcome: nil,
         payment_method_details: nil,
-        payment_reference: nil,
+        processor_details: nil,
         shipping_details: nil
       )
         @amount_requested = amount_requested
@@ -1490,18 +1575,26 @@ module Stripe
         @metadata = metadata
         @outcome = outcome
         @payment_method_details = payment_method_details
-        @payment_reference = payment_reference
+        @processor_details = processor_details
         @shipping_details = shipping_details
       end
     end
     # A representation of an amount of money, consisting of an amount and a currency.
+    attr_reader :amount
+    # A representation of an amount of money, consisting of an amount and a currency.
+    attr_reader :amount_authorized
+    # A representation of an amount of money, consisting of an amount and a currency.
     attr_reader :amount_canceled
     # A representation of an amount of money, consisting of an amount and a currency.
     attr_reader :amount_failed
     # A representation of an amount of money, consisting of an amount and a currency.
     attr_reader :amount_guaranteed
     # A representation of an amount of money, consisting of an amount and a currency.
+    attr_reader :amount_refunded
+    # A representation of an amount of money, consisting of an amount and a currency.
     attr_reader :amount_requested
+    # ID of the Connect application that created the PaymentRecord.
+    attr_reader :application
     # Time at which the object was created. Measured in seconds since the Unix epoch.
     attr_reader :created
     # Customer information for this payment.
@@ -1522,8 +1615,8 @@ module Stripe
     attr_reader :object
     # Information about the Payment Method debited for this payment.
     attr_reader :payment_method_details
-    # An opaque string for manual reconciliation of this payment, for example a check number or a payment processor ID.
-    attr_reader :payment_reference
+    # Processor information associated with this payment.
+    attr_reader :processor_details
     # Shipping information for this payment.
     attr_reader :shipping_details
 

data/lib/stripe/resources/promotion_code.rb

@@ -2,8 +2,11 @@
 # frozen_string_literal: true
 
 module Stripe
-  # A Promotion Code represents a customer-redeemable code for a [coupon](https://stripe.com/docs/api#coupons). It can be used to
-  # create multiple codes for a single coupon.
+  # A Promotion Code represents a customer-redeemable code for a [coupon](https://stripe.com/docs/api#coupons).
+  # You can create multiple codes for a single coupon.
+  #
+  # If you enable promotion codes in your [customer portal configuration](https://stripe.com/docs/customer-management/configure-portal), then customers can redeem a code themselves when updating a subscription in the portal.
+  # Customers can also view the currently active promotion codes and coupons on each of their subscriptions in the portal.
   class PromotionCode < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List

data/lib/stripe/resources/quote_preview_invoice.rb

@@ -179,7 +179,7 @@ module Stripe
       attr_reader :message
       # For card errors resulting from a card issuer decline, a 2 digit code which indicates the advice given to merchant by the card network on how to proceed with an error.
       attr_reader :network_advice_code
-      # For card errors resulting from a card issuer decline, a brand specific 2, 3, or 4 digit code which indicates the reason the authorization failed.
+      # For payments declined by the network, an alphanumeric code which indicates the reason the payment failed.
       attr_reader :network_decline_code
       # If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
       attr_reader :param
@@ -234,6 +234,11 @@ module Stripe
     end
 
     class Parent < Stripe::StripeObject
+      class BillingCadenceDetails < Stripe::StripeObject
+        # The billing cadence that generated this invoice
+        attr_reader :billing_cadence
+      end
+
       class QuoteDetails < Stripe::StripeObject
         # The quote that generated this invoice
         attr_reader :quote
@@ -256,6 +261,8 @@ module Stripe
         # Only set for upcoming invoices that preview prorations. The time used to calculate prorations.
         attr_reader :subscription_proration_date
       end
+      # Details about the billing cadence that generated this invoice
+      attr_reader :billing_cadence_details
       # Details about the quote that generated this invoice
       attr_reader :quote_details
       # Details about the subscription that generated this invoice

data/lib/stripe/resources/quote_preview_subscription_schedule.rb

@@ -130,8 +130,32 @@ module Stripe
           # ID of the promotion code to create a new discount for.
           attr_reader :promotion_code
         end
+
+        class Period < Stripe::StripeObject
+          class End < Stripe::StripeObject
+            # A precise Unix timestamp for the end of the invoice item period. Must be greater than or equal to `period.start`.
+            attr_reader :timestamp
+            # Select how to calculate the end of the invoice item period.
+            attr_reader :type
+          end
+
+          class Start < Stripe::StripeObject
+            # A precise Unix timestamp for the start of the invoice item period. Must be less than or equal to `period.end`.
+            attr_reader :timestamp
+            # Select how to calculate the start of the invoice item period.
+            attr_reader :type
+          end
+          # Attribute for field end
+          attr_reader :end
+          # Attribute for field start
+          attr_reader :start
+        end
         # The stackable discounts that will be applied to the item.
         attr_reader :discounts
+        # 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
+        # Attribute for field period
+        attr_reader :period
         # ID of the price used to generate the invoice item.
         attr_reader :price
         # The quantity of the invoice item.