stripe 19.4.0.pre.alpha.2 → 19.4.0.pre.alpha.4

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

@@ -146,6 +146,8 @@ module Stripe
         attr_reader :address
         # Address validation details for the shipment.
         attr_reader :address_validation
+        # The name of the business at the shipping address, used on the shipping label to ensure delivery when the card is shipped to a cardholder's workplace.
+        attr_reader :business_name
         # The delivery company that shipped a card.
         attr_reader :carrier
         # Additional information that may be required for clearing customs.

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

@@ -185,17 +185,43 @@ module Stripe
       end
 
       class NetworkData < ::Stripe::StripeObject
+        class TraceId < ::Stripe::StripeObject
+          # The unique reference number within the specified financial network on the specified network date.
+          attr_reader :banknet_reference_number
+          # The identifier of the program or service.
+          attr_reader :financial_network_code
+          # The card network's record date for this transaction.
+          attr_reader :network_date
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
         # The network-provided acquirer reference number for this transaction, if available. Use this value for downstream operational workflows such as filing disputes with the card network.
         attr_reader :acquirer_reference_number
+        # The two-letter country code of the acquirer ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+        attr_reader :acquiring_institution_country
+        # Identifier assigned to the acquirer by the card network. Sometimes this value is not provided by the network; in this case, the value will be null.
+        attr_reader :acquiring_institution_id
         # 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.
         attr_reader :processing_date
+        # Identifier assigned by the acquirer to track all messages related to this transaction.
+        attr_reader :retrieval_reference_number
+        # The card network over which Stripe received the transaction. This field may differ from the associated card’s primary network.
+        attr_reader :routed_network
+        # Mastercard identifier assigned by the card network for the transaction.
+        attr_reader :trace_id
         # Unique identifier for the authorization assigned by the card network used to match subsequent messages, disputes, and transactions.
         attr_reader :transaction_id
 
         def self.inner_class_types
-          @inner_class_types = {}
+          @inner_class_types = { trace_id: TraceId }
         end
 
         def self.field_remappings
@@ -228,7 +254,7 @@ module Stripe
 
           class ReportedBreakdown < ::Stripe::StripeObject
             class Fuel < ::Stripe::StripeObject
-              # Gross fuel amount that should equal Fuel Volume multipled by Fuel Unit Cost, inclusive of taxes.
+              # Gross fuel amount that should equal Fuel Volume multiplied by Fuel Unit Cost, inclusive of taxes.
               attr_reader :gross_amount_decimal
 
               def self.inner_class_types
@@ -524,6 +550,23 @@ module Stripe
         end
       end
 
+      class SettlementDetails < ::Stripe::StripeObject
+        # `merchant_amount` in the settlement currency.
+        attr_reader :amount
+        # Settlement currency.
+        attr_reader :currency
+        # Exchange rate used by the network to convert the `merchant_amount` to `settlement_details.amount`. The `merchant_amount` multiplied with this rate will equal to the `settlement_details.amount`.
+        attr_reader :exchange_rate
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
       class Treasury < ::Stripe::StripeObject
         # The Treasury [ReceivedCredit](https://docs.stripe.com/api/treasury/received_credits) representing this Issuing transaction if it is a refund
         attr_reader :received_credit
@@ -582,6 +625,8 @@ module Stripe
       attr_reader :redaction
       # The ID of the [settlement](https://docs.stripe.com/api/issuing/settlements) to which this transaction belongs.
       attr_reader :settlement
+      # Details about the transaction for settlement reconciliation.
+      attr_reader :settlement_details
       # [Token](https://docs.stripe.com/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://docs.stripe.com/api/treasury) details related to this transaction if it was created on a [FinancialAccount](/docs/api/treasury/financial_accounts
@@ -670,6 +715,7 @@ module Stripe
           network_data: NetworkData,
           purchase_details: PurchaseDetails,
           redaction: Redaction,
+          settlement_details: SettlementDetails,
           treasury: Treasury,
         }
       end

data/lib/stripe/resources/order.rb

@@ -722,7 +722,7 @@ module Stripe
 
     class TaxDetails < ::Stripe::StripeObject
       class TaxId < ::Stripe::StripeObject
-        # The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `pl_nip`, `it_cf`, `fo_vat`, `gi_tin`, `py_ruc`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `lk_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, or `unknown`
+        # The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `pl_nip`, `it_cf`, `fo_vat`, `gi_tin`, `py_ruc`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `lk_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, `ic_nif`, or `unknown`
         attr_reader :type
         # The value of the tax ID.
         attr_reader :value

data/lib/stripe/resources/payment_attempt_record.rb

@@ -285,7 +285,7 @@ module Stripe
       class AmazonPay < ::Stripe::StripeObject
         class Funding < ::Stripe::StripeObject
           class Card < ::Stripe::StripeObject
-            # Card brand. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa` or `unknown`.
+            # Card brand. Can be `American Express`, `Cartes Bancaires`, `Diners Club`, `Discover`, `Eftpos Australia`, `Girocard`, `JCB`, `MasterCard`, `UnionPay`, `Visa`, or `Unknown`.
             attr_reader :brand
             # The [product code](https://stripe.com/docs/card-product-codes) that identifies the specific program or product associated with a card. (For internal use only and not typically available in standard API requests.)
             attr_reader :brand_product
@@ -932,7 +932,7 @@ module Stripe
       class Fpx < ::Stripe::StripeObject
         # Account holder type, if provided. Can be one of `individual` or `company`.
         attr_reader :account_holder_type
-        # The customer's bank. Can be one of `affin_bank`, `agrobank`, `alliance_bank`, `ambank`, `bank_islam`, `bank_muamalat`, `bank_rakyat`, `bsn`, `cimb`, `hong_leong_bank`, `hsbc`, `kfh`, `maybank2u`, `ocbc`, `public_bank`, `rhb`, `standard_chartered`, `uob`, `deutsche_bank`, `maybank2e`, `pb_enterprise`, or `bank_of_china`.
+        # The customer's bank. Can be one of `affin_bank`, `agrobank`, `alliance_bank`, `ambank`, `bank_islam`, `bank_muamalat`, `bnp_paribas`, `bank_rakyat`, `bsn`, `cimb`, `citibank`, `hong_leong_bank`, `hsbc`, `kfh`, `maybank2u`, `ocbc`, `public_bank`, `rhb`, `standard_chartered`, `uob`, `deutsche_bank`, `maybank2e`, `mbsb_bank`, `pb_enterprise`, or `bank_of_china`.
         attr_reader :bank
         # Unique transaction id generated by FPX for every request from the merchant
         attr_reader :transaction_id

data/lib/stripe/resources/payment_intent.rb

@@ -365,6 +365,9 @@ module Stripe
       attr_reader :decline_code
       # A URL to more information about the [error code](https://docs.stripe.com/error-codes) reported.
       attr_reader :doc_url
+      # A GiftCardOperation represents an operation performed on a third-party gift card,
+      # such as activation, reload, cashout, balance check, or void.
+      attr_reader :gift_card_operation
       # A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.
       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.
@@ -4288,6 +4291,14 @@ module Stripe
       class Payco < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
+        # 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.
+        #
+        # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
+        #
+        # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
+        attr_reader :setup_future_usage
 
         def self.inner_class_types
           @inner_class_types = {}
@@ -4389,6 +4400,15 @@ module Stripe
       end
 
       class Paypay < ::Stripe::StripeObject
+        # 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.
+        #
+        # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
+        #
+        # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
+        attr_reader :setup_future_usage
+
         def self.inner_class_types
           @inner_class_types = {}
         end
@@ -4566,6 +4586,14 @@ module Stripe
       class SamsungPay < ::Stripe::StripeObject
         # Controls when the funds will be captured from the customer's account.
         attr_reader :capture_method
+        # 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.
+        #
+        # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
+        #
+        # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
+        attr_reader :setup_future_usage
 
         def self.inner_class_types
           @inner_class_types = {}

data/lib/stripe/resources/payment_method.rb

@@ -927,7 +927,7 @@ module Stripe
     class Fpx < ::Stripe::StripeObject
       # Account holder type, if provided. Can be one of `individual` or `company`.
       attr_reader :account_holder_type
-      # The customer's bank, if provided. Can be one of `affin_bank`, `agrobank`, `alliance_bank`, `ambank`, `bank_islam`, `bank_muamalat`, `bank_rakyat`, `bsn`, `cimb`, `hong_leong_bank`, `hsbc`, `kfh`, `maybank2u`, `ocbc`, `public_bank`, `rhb`, `standard_chartered`, `uob`, `deutsche_bank`, `maybank2e`, `pb_enterprise`, or `bank_of_china`.
+      # The customer's bank, if provided. Can be one of `affin_bank`, `agrobank`, `alliance_bank`, `ambank`, `bank_islam`, `bank_muamalat`, `bnp_paribas`, `bank_rakyat`, `bsn`, `cimb`, `citibank`, `hong_leong_bank`, `hsbc`, `kfh`, `maybank2u`, `ocbc`, `public_bank`, `rhb`, `standard_chartered`, `uob`, `deutsche_bank`, `maybank2e`, `mbsb_bank`, `pb_enterprise`, or `bank_of_china`.
       attr_reader :bank
 
       def self.inner_class_types
@@ -1908,7 +1908,7 @@ module Stripe
       request_stripe_object(method: :post, path: "/v1/payment_methods", params: params, opts: opts)
     end
 
-    # Detaches a PaymentMethod object from a Customer. After a PaymentMethod is detached, it can no longer be used for a payment or re-attached to a Customer.
+    # Detaches a PaymentMethod object from a Customer. Detachment is permanent and irreversible — once detached, a PaymentMethod can no longer be used for payments or re-attached to a Customer.
     def detach(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -1918,7 +1918,7 @@ module Stripe
       )
     end
 
-    # Detaches a PaymentMethod object from a Customer. After a PaymentMethod is detached, it can no longer be used for a payment or re-attached to a Customer.
+    # Detaches a PaymentMethod object from a Customer. Detachment is permanent and irreversible — once detached, a PaymentMethod can no longer be used for payments or re-attached to a Customer.
     def self.detach(payment_method, params = {}, opts = {})
       request_stripe_object(
         method: :post,

data/lib/stripe/resources/payment_record.rb

@@ -7,6 +7,7 @@ module Stripe
   # in order to mark an Invoice as paid and a Subscription as active. Payment Records consist of one or
   # more Payment Attempt Records, which represent individual attempts made on a payment network.
   class PaymentRecord < APIResource
+    extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::Search
 
     OBJECT_NAME = "payment_record"
@@ -285,7 +286,7 @@ module Stripe
       class AmazonPay < ::Stripe::StripeObject
         class Funding < ::Stripe::StripeObject
           class Card < ::Stripe::StripeObject
-            # Card brand. Can be `amex`, `cartes_bancaires`, `diners`, `discover`, `eftpos_au`, `jcb`, `link`, `mastercard`, `unionpay`, `visa` or `unknown`.
+            # Card brand. Can be `American Express`, `Cartes Bancaires`, `Diners Club`, `Discover`, `Eftpos Australia`, `Girocard`, `JCB`, `MasterCard`, `UnionPay`, `Visa`, or `Unknown`.
             attr_reader :brand
             # The [product code](https://stripe.com/docs/card-product-codes) that identifies the specific program or product associated with a card. (For internal use only and not typically available in standard API requests.)
             attr_reader :brand_product
@@ -932,7 +933,7 @@ module Stripe
       class Fpx < ::Stripe::StripeObject
         # Account holder type, if provided. Can be one of `individual` or `company`.
         attr_reader :account_holder_type
-        # The customer's bank. Can be one of `affin_bank`, `agrobank`, `alliance_bank`, `ambank`, `bank_islam`, `bank_muamalat`, `bank_rakyat`, `bsn`, `cimb`, `hong_leong_bank`, `hsbc`, `kfh`, `maybank2u`, `ocbc`, `public_bank`, `rhb`, `standard_chartered`, `uob`, `deutsche_bank`, `maybank2e`, `pb_enterprise`, or `bank_of_china`.
+        # The customer's bank. Can be one of `affin_bank`, `agrobank`, `alliance_bank`, `ambank`, `bank_islam`, `bank_muamalat`, `bnp_paribas`, `bank_rakyat`, `bsn`, `cimb`, `citibank`, `hong_leong_bank`, `hsbc`, `kfh`, `maybank2u`, `ocbc`, `public_bank`, `rhb`, `standard_chartered`, `uob`, `deutsche_bank`, `maybank2e`, `mbsb_bank`, `pb_enterprise`, or `bank_of_china`.
         attr_reader :bank
         # Unique transaction id generated by FPX for every request from the merchant
         attr_reader :transaction_id
@@ -2359,6 +2360,17 @@ module Stripe
     # Shipping information for this payment.
     attr_reader :shipping_details
 
+    # Report that the most recent payment attempt on the specified Payment Record
+    #  was disputed.
+    def self.create(id, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/payment_records/%<id>s/report_dispute", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts
+      )
+    end
+
     # Report a new Payment Record. You may report a Payment Record as it is
     #  initialized and later report updates through the other report_* methods, or report Payment
     #  Records in a terminal state directly, through this method.

data/lib/stripe/resources/person.rb

@@ -193,7 +193,7 @@ module Stripe
       attr_reader :alternatives
       # Fields that need to be resolved to keep the person's account enabled. If not resolved by the account's `future_requirements[current_deadline]`, these fields will transition to the main `requirements` hash, and may immediately become `past_due`, but the account may also be given a grace period depending on the account's enablement state prior to transition.
       attr_reader :currently_due
-      # Details about validation and verification failures for `due` requirements that must be resolved.
+      # Fields that are `currently_due` and need to be collected again because validation or verification failed.
       attr_reader :errors
       # Fields you must collect when all thresholds are reached. As they become required, they appear in `currently_due` as well, and the account's `future_requirements[current_deadline]` becomes set.
       attr_reader :eventually_due
@@ -297,7 +297,7 @@ module Stripe
       attr_reader :alternatives
       # Fields that need to be resolved to keep the person's account enabled. If not resolved by the account's `current_deadline`, these fields will appear in `past_due` as well, and the account is disabled.
       attr_reader :currently_due
-      # Details about validation and verification failures for `due` requirements that must be resolved.
+      # Fields that are `currently_due` and need to be collected again because validation or verification failed.
       attr_reader :errors
       # Fields you must collect when all thresholds are reached. As they become required, they appear in `currently_due` as well, and the account's `current_deadline` becomes set.
       attr_reader :eventually_due

data/lib/stripe/resources/profile.rb

@@ -11,7 +11,7 @@ module Stripe
 
     class Branding < ::Stripe::StripeObject
       class Icon < ::Stripe::StripeObject
-        # Attribute for field original
+        # The original image.
         attr_reader :original
 
         def self.inner_class_types
@@ -24,7 +24,7 @@ module Stripe
       end
 
       class Logo < ::Stripe::StripeObject
-        # Attribute for field original
+        # The original image.
         attr_reader :original
 
         def self.inner_class_types
@@ -35,13 +35,13 @@ module Stripe
           @field_remappings = {}
         end
       end
-      # Attribute for field icon
+      # Profile icon image.
       attr_reader :icon
-      # Attribute for field logo
+      # Profile logo image.
       attr_reader :logo
-      # Attribute for field primary_color
+      # The primary brand color for the profile.
       attr_reader :primary_color
-      # Attribute for field secondary_color
+      # The secondary brand color for the profile.
       attr_reader :secondary_color
 
       def self.inner_class_types
@@ -52,21 +52,21 @@ module Stripe
         @field_remappings = {}
       end
     end
-    # Attribute for field branding
+    # Branding information for the Stripe profile.
     attr_reader :branding
-    # Attribute for field description
+    # A description of the business or entity represented by the Stripe profile.
     attr_reader :description
-    # Attribute for field display_name
+    # The display name shown for the Stripe profile.
     attr_reader :display_name
-    # Attribute for field id
+    # Unique identifier for the Stripe profile.
     attr_reader :id
-    # Attribute for field livemode
+    # 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
-    # Attribute for field object
+    # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object
-    # Attribute for field url
+    # The external website URL associated with the Stripe profile.
     attr_reader :url
-    # Attribute for field username
+    # The unique username for the Stripe profile.
     attr_reader :username
 
     def self.inner_class_types

data/lib/stripe/resources/quote.rb

@@ -300,6 +300,21 @@ module Stripe
     end
 
     class InvoiceSettings < ::Stripe::StripeObject
+      class CustomField < ::Stripe::StripeObject
+        # The name of the custom field.
+        attr_reader :name
+        # The value of the custom field.
+        attr_reader :value
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
       class Issuer < ::Stripe::StripeObject
         # The connected account being referenced when `type` is `account`.
         attr_reader :account
@@ -314,13 +329,19 @@ module Stripe
           @field_remappings = {}
         end
       end
+      # A list of up to 4 custom fields to be displayed on the invoice.
+      attr_reader :custom_fields
       # Number of days within which a customer must pay invoices generated by this quote. This value will be `null` for quotes where `collection_method=charge_automatically`.
       attr_reader :days_until_due
+      # An arbitrary string attached to the object. Often useful for displaying to users.
+      attr_reader :description
+      # Footer to be displayed on the invoice.
+      attr_reader :footer
       # Attribute for field issuer
       attr_reader :issuer
 
       def self.inner_class_types
-        @inner_class_types = { issuer: Issuer }
+        @inner_class_types = { custom_fields: CustomField, issuer: Issuer }
       end
 
       def self.field_remappings

data/lib/stripe/resources/quote_preview_invoice.rb

@@ -216,7 +216,7 @@ module Stripe
     end
 
     class CustomerTaxId < ::Stripe::StripeObject
-      # The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `pl_nip`, `it_cf`, `fo_vat`, `gi_tin`, `py_ruc`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `lk_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, or `unknown`
+      # The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `pl_nip`, `it_cf`, `fo_vat`, `gi_tin`, `py_ruc`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `lk_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, `ic_nif`, or `unknown`
       attr_reader :type
       # The value of the tax ID.
       attr_reader :value
@@ -271,6 +271,9 @@ module Stripe
       attr_reader :decline_code
       # A URL to more information about the [error code](https://docs.stripe.com/error-codes) reported.
       attr_reader :doc_url
+      # A GiftCardOperation represents an operation performed on a third-party gift card,
+      # such as activation, reload, cashout, balance check, or void.
+      attr_reader :gift_card_operation
       # A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.
       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.

data/lib/stripe/resources/quote_preview_subscription_schedule.rb

@@ -181,6 +181,21 @@ module Stripe
       end
 
       class InvoiceSettings < ::Stripe::StripeObject
+        class CustomField < ::Stripe::StripeObject
+          # The name of the custom field.
+          attr_reader :name
+          # The value of the custom field.
+          attr_reader :value
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
         class Issuer < ::Stripe::StripeObject
           # The connected account being referenced when `type` is `account`.
           attr_reader :account
@@ -197,13 +212,19 @@ module Stripe
         end
         # The account tax IDs associated with the subscription schedule. Will be set on invoices generated by the subscription schedule.
         attr_reader :account_tax_ids
+        # A list of up to 4 custom fields to be displayed on the invoice.
+        attr_reader :custom_fields
         # Number of days within which a customer must pay invoices generated by this subscription schedule. This value will be `null` for subscription schedules where `billing=charge_automatically`.
         attr_reader :days_until_due
+        # An arbitrary string attached to the object. Often useful for displaying to users.
+        attr_reader :description
+        # Footer to be displayed on the invoice.
+        attr_reader :footer
         # Attribute for field issuer
         attr_reader :issuer
 
         def self.inner_class_types
-          @inner_class_types = { issuer: Issuer }
+          @inner_class_types = { custom_fields: CustomField, issuer: Issuer }
         end
 
         def self.field_remappings
@@ -293,6 +314,126 @@ module Stripe
       end
     end
 
+    class PauseSchedule < ::Stripe::StripeObject
+      class Pause < ::Stripe::StripeObject
+        class Settings < ::Stripe::StripeObject
+          class BillFor < ::Stripe::StripeObject
+            class OutstandingUsageThrough < ::Stripe::StripeObject
+              # The type of outstanding usage billing behavior.
+              attr_reader :type
+
+              def self.inner_class_types
+                @inner_class_types = {}
+              end
+
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
+
+            class UnusedTimeFrom < ::Stripe::StripeObject
+              # The type of unused time credit behavior.
+              attr_reader :type
+
+              def self.inner_class_types
+                @inner_class_types = {}
+              end
+
+              def self.field_remappings
+                @field_remappings = {}
+              end
+            end
+            # Attribute for field outstanding_usage_through
+            attr_reader :outstanding_usage_through
+            # Attribute for field unused_time_from
+            attr_reader :unused_time_from
+
+            def self.inner_class_types
+              @inner_class_types = {
+                outstanding_usage_through: OutstandingUsageThrough,
+                unused_time_from: UnusedTimeFrom,
+              }
+            end
+
+            def self.field_remappings
+              @field_remappings = {}
+            end
+          end
+          # Attribute for field bill_for
+          attr_reader :bill_for
+          # Determines how to handle debits and credits when pausing.
+          attr_reader :invoicing_behavior
+          # The type of pause settings.
+          attr_reader :type
+
+          def self.inner_class_types
+            @inner_class_types = { bill_for: BillFor }
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Time at which the subscription pauses.
+        attr_reader :pause_at
+        # Settings controlling billing behavior during the pause.
+        attr_reader :settings
+
+        def self.inner_class_types
+          @inner_class_types = { settings: Settings }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+
+      class Resume < ::Stripe::StripeObject
+        class Settings < ::Stripe::StripeObject
+          # The billing cycle anchor that applies when the subscription is resumed.
+          attr_reader :billing_cycle_anchor
+          # Controls whether Stripe attempts payment on the resumption invoice and how that affects the subscription's status.
+          attr_reader :payment_behavior
+          # Determines how to handle prorations resulting from the billing_cycle_anchor change on resume.
+          attr_reader :proration_behavior
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+        # Time at which the subscription resumes.
+        attr_reader :resume_at
+        # Attribute for field settings
+        attr_reader :settings
+
+        def self.inner_class_types
+          @inner_class_types = { settings: Settings }
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
+      # A unique identifier for this pause schedule.
+      attr_reader :key
+      # Attribute for field pause
+      attr_reader :pause
+      # Details about when and how the subscription resumes.
+      attr_reader :resume
+
+      def self.inner_class_types
+        @inner_class_types = { pause: Pause, resume: Resume }
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+
     class Phase < ::Stripe::StripeObject
       class AddInvoiceItem < ::Stripe::StripeObject
         class Discount < ::Stripe::StripeObject
@@ -526,6 +667,21 @@ module Stripe
       end
 
       class InvoiceSettings < ::Stripe::StripeObject
+        class CustomField < ::Stripe::StripeObject
+          # The name of the custom field.
+          attr_reader :name
+          # The value of the custom field.
+          attr_reader :value
+
+          def self.inner_class_types
+            @inner_class_types = {}
+          end
+
+          def self.field_remappings
+            @field_remappings = {}
+          end
+        end
+
         class Issuer < ::Stripe::StripeObject
           # The connected account being referenced when `type` is `account`.
           attr_reader :account
@@ -542,13 +698,19 @@ module Stripe
         end
         # The account tax IDs associated with this phase of the subscription schedule. Will be set on invoices generated by this phase of the subscription schedule.
         attr_reader :account_tax_ids
+        # A list of up to 4 custom fields to be displayed on the invoice.
+        attr_reader :custom_fields
         # Number of days within which a customer must pay invoices generated by this subscription schedule. This value will be `null` for subscription schedules where `billing=charge_automatically`.
         attr_reader :days_until_due
+        # An arbitrary string attached to the object. Often useful for displaying to users.
+        attr_reader :description
+        # Footer to be displayed on the invoice.
+        attr_reader :footer
         # The connected account that issues the invoice. The invoice is presented with the branding and support information of the specified account.
         attr_reader :issuer
 
         def self.inner_class_types
-          @inner_class_types = { issuer: Issuer }
+          @inner_class_types = { custom_fields: CustomField, issuer: Issuer }
         end
 
         def self.field_remappings
@@ -794,6 +956,8 @@ module Stripe
       attr_reader :start_date
       # The account (if any) the associated subscription's payments will be attributed to for tax reporting, and where funds from each payment will be transferred to for each of the subscription's invoices.
       attr_reader :transfer_data
+      # If set to true the entire phase is counted as a trial and the customer will not be charged for any fees.
+      attr_reader :trial
       # Specify behavior of the trial when crossing schedule phase boundaries
       attr_reader :trial_continuation
       # When the trial ends within the phase.
@@ -876,6 +1040,8 @@ module Stripe
     attr_reader :metadata
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object
+    # The pause schedules for this subscription schedule.
+    attr_reader :pause_schedules
     # Configuration for the subscription schedule's phases.
     attr_reader :phases
     # Time period and invoice for a Subscription billed in advance.
@@ -899,6 +1065,7 @@ module Stripe
         current_phase: CurrentPhase,
         default_settings: DefaultSettings,
         last_price_migration_error: LastPriceMigrationError,
+        pause_schedules: PauseSchedule,
         phases: Phase,
         prebilling: Prebilling,
       }