stripe 17.0.1 → 19.0.0

data/lib/stripe/resources/connect_collection_transfer.rb

@@ -16,7 +16,7 @@ module Stripe
     attr_reader :destination
     # 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.
+    # 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
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object

data/lib/stripe/resources/country_spec.rb

@@ -16,8 +16,8 @@ module Stripe
       "country_spec"
     end
 
-    class VerificationFields < Stripe::StripeObject
-      class Company < Stripe::StripeObject
+    class VerificationFields < ::Stripe::StripeObject
+      class Company < ::Stripe::StripeObject
         # Additional fields which are only required for some users.
         attr_reader :additional
         # Fields which every account must eventually provide.
@@ -32,7 +32,7 @@ module Stripe
         end
       end
 
-      class Individual < Stripe::StripeObject
+      class Individual < ::Stripe::StripeObject
         # Additional fields which are only required for some users.
         attr_reader :additional
         # Fields which every account must eventually provide.

data/lib/stripe/resources/coupon.rb

@@ -3,8 +3,8 @@
 
 module Stripe
   # A coupon contains information about a percent-off or amount-off discount you
-  # might want to apply to a customer. Coupons may be applied to [subscriptions](https://stripe.com/docs/api#subscriptions), [invoices](https://stripe.com/docs/api#invoices),
-  # [checkout sessions](https://stripe.com/docs/api/checkout/sessions), [quotes](https://stripe.com/docs/api#quotes), and more. Coupons do not work with conventional one-off [charges](https://stripe.com/docs/api#create_charge) or [payment intents](https://stripe.com/docs/api/payment_intents).
+  # might want to apply to a customer. Coupons may be applied to [subscriptions](https://api.stripe.com#subscriptions), [invoices](https://api.stripe.com#invoices),
+  # [checkout sessions](https://docs.stripe.com/api/checkout/sessions), [quotes](https://api.stripe.com#quotes), and more. Coupons do not work with conventional one-off [charges](https://docs.stripe.com/api/charges/create) or [payment intents](https://docs.stripe.com/api/payment_intents).
   class Coupon < APIResource
     extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Delete
@@ -16,7 +16,7 @@ module Stripe
       "coupon"
     end
 
-    class AppliesTo < Stripe::StripeObject
+    class AppliesTo < ::Stripe::StripeObject
       # A list of product IDs this coupon applies to
       attr_reader :products
 
@@ -29,7 +29,7 @@ module Stripe
       end
     end
 
-    class CurrencyOptions < Stripe::StripeObject
+    class CurrencyOptions < ::Stripe::StripeObject
       # Amount (in the `currency` specified) that will be taken off the subtotal of any invoices for this customer.
       attr_reader :amount_off
 
@@ -57,11 +57,11 @@ module Stripe
     attr_reader :duration_in_months
     # 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.
+    # 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
     # Maximum number of times this coupon can be redeemed, in total, across all customers, before it is no longer valid.
     attr_reader :max_redemptions
-    # 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.
+    # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
     attr_reader :metadata
     # Name of the coupon displayed to customers on for instance invoices or receipts.
     attr_reader :name

data/lib/stripe/resources/credit_note.rb

@@ -4,7 +4,7 @@
 module Stripe
   # Issue a credit note to adjust an invoice's amount after the invoice is finalized.
   #
-  # Related guide: [Credit notes](https://stripe.com/docs/billing/invoices/credit-notes)
+  # Related guide: [Credit notes](https://docs.stripe.com/billing/invoices/credit-notes)
   class CreditNote < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
@@ -15,7 +15,7 @@ module Stripe
       "credit_note"
     end
 
-    class DiscountAmount < Stripe::StripeObject
+    class DiscountAmount < ::Stripe::StripeObject
       # The amount, in cents (or local equivalent), of the discount.
       attr_reader :amount
       # The discount that was applied to get this discount amount.
@@ -30,7 +30,7 @@ module Stripe
       end
     end
 
-    class PretaxCreditAmount < Stripe::StripeObject
+    class PretaxCreditAmount < ::Stripe::StripeObject
       # The amount, in cents (or local equivalent), of the pretax credit amount.
       attr_reader :amount
       # The credit balance transaction that was applied to get this pretax credit amount.
@@ -49,14 +49,32 @@ module Stripe
       end
     end
 
-    class Refund < Stripe::StripeObject
+    class Refund < ::Stripe::StripeObject
+      class PaymentRecordRefund < ::Stripe::StripeObject
+        # ID of the payment record.
+        attr_reader :payment_record
+        # ID of the refund group.
+        attr_reader :refund_group
+
+        def self.inner_class_types
+          @inner_class_types = {}
+        end
+
+        def self.field_remappings
+          @field_remappings = {}
+        end
+      end
       # Amount of the refund that applies to this credit note, in cents (or local equivalent).
       attr_reader :amount_refunded
+      # The PaymentRecord refund details associated with this credit note refund.
+      attr_reader :payment_record_refund
       # ID of the refund.
       attr_reader :refund
+      # Type of the refund, one of `refund` or `payment_record_refund`.
+      attr_reader :type
 
       def self.inner_class_types
-        @inner_class_types = {}
+        @inner_class_types = { payment_record_refund: PaymentRecordRefund }
       end
 
       def self.field_remappings
@@ -64,8 +82,8 @@ module Stripe
       end
     end
 
-    class ShippingCost < Stripe::StripeObject
-      class Tax < Stripe::StripeObject
+    class ShippingCost < ::Stripe::StripeObject
+      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.
@@ -105,9 +123,9 @@ module Stripe
       end
     end
 
-    class TotalTax < Stripe::StripeObject
-      class TaxRateDetails < Stripe::StripeObject
-        # Attribute for field tax_rate
+    class TotalTax < ::Stripe::StripeObject
+      class TaxRateDetails < ::Stripe::StripeObject
+        # ID of the tax rate
         attr_reader :tax_rate
 
         def self.inner_class_types
@@ -149,6 +167,8 @@ module Stripe
     attr_reader :currency
     # ID of the customer.
     attr_reader :customer
+    # ID of the account representing the customer.
+    attr_reader :customer_account
     # Customer balance transaction related to this credit note.
     attr_reader :customer_balance_transaction
     # The integer amount in cents (or local equivalent) representing the total amount of discount that was credited.
@@ -163,11 +183,11 @@ module Stripe
     attr_reader :invoice
     # Line items that make up the credit note
     attr_reader :lines
-    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    # 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
     # Customer-facing text that appears on the credit note PDF.
     attr_reader :memo
-    # 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.
+    # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
     attr_reader :metadata
     # A unique number that identifies this particular credit note and appears on the PDF of the credit note and its associated invoice.
     attr_reader :number
@@ -189,7 +209,7 @@ module Stripe
     attr_reader :refunds
     # The details of the cost of shipping, including the ShippingRate applied to the invoice.
     attr_reader :shipping_cost
-    # Status of this credit note, one of `issued` or `void`. Learn more about [voiding credit notes](https://stripe.com/docs/billing/invoices/credit-notes#voiding).
+    # Status of this credit note, one of `issued` or `void`. Learn more about [voiding credit notes](https://docs.stripe.com/billing/invoices/credit-notes#voiding).
     attr_reader :status
     # The integer amount in cents (or local equivalent) representing the amount of the credit note, excluding exclusive tax and invoice level discounts.
     attr_reader :subtotal

data/lib/stripe/resources/credit_note_line_item.rb

@@ -9,7 +9,7 @@ module Stripe
       "credit_note_line_item"
     end
 
-    class DiscountAmount < Stripe::StripeObject
+    class DiscountAmount < ::Stripe::StripeObject
       # The amount, in cents (or local equivalent), of the discount.
       attr_reader :amount
       # The discount that was applied to get this discount amount.
@@ -24,7 +24,7 @@ module Stripe
       end
     end
 
-    class PretaxCreditAmount < Stripe::StripeObject
+    class PretaxCreditAmount < ::Stripe::StripeObject
       # The amount, in cents (or local equivalent), of the pretax credit amount.
       attr_reader :amount
       # The credit balance transaction that was applied to get this pretax credit amount.
@@ -43,9 +43,9 @@ module Stripe
       end
     end
 
-    class Tax < Stripe::StripeObject
-      class TaxRateDetails < Stripe::StripeObject
-        # Attribute for field tax_rate
+    class Tax < ::Stripe::StripeObject
+      class TaxRateDetails < ::Stripe::StripeObject
+        # ID of the tax rate
         attr_reader :tax_rate
 
         def self.inner_class_types
@@ -89,8 +89,10 @@ module Stripe
     attr_reader :id
     # ID of the invoice line item being credited
     attr_reader :invoice_line_item
-    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
     attr_reader :livemode
+    # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+    attr_reader :metadata
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object
     # The pretax credit amounts (ex: discount, credit grants, etc) for this line item.
@@ -119,5 +121,9 @@ module Stripe
     def self.field_remappings
       @field_remappings = {}
     end
+
+    def self.field_encodings
+      @field_encodings = { unit_amount_decimal: :decimal_string }
+    end
   end
 end

data/lib/stripe/resources/customer.rb

@@ -2,7 +2,7 @@
 # frozen_string_literal: true
 
 module Stripe
-  # This object represents a customer of your business. Use it to [create recurring charges](https://stripe.com/docs/invoicing/customer), [save payment](https://stripe.com/docs/payments/save-during-payment) and contact information,
+  # This object represents a customer of your business. Use it to [create recurring charges](https://docs.stripe.com/invoicing/customer), [save payment](https://docs.stripe.com/payments/save-during-payment) and contact information,
   # and track payments that belong to the same customer.
   class Customer < APIResource
     extend Stripe::APIOperations::Create
@@ -22,7 +22,7 @@ module Stripe
     nested_resource_class_methods :source, operations: %i[create retrieve update delete list]
     nested_resource_class_methods :tax_id, operations: %i[create retrieve delete list]
 
-    class Address < Stripe::StripeObject
+    class Address < ::Stripe::StripeObject
       # City, district, suburb, town, or village.
       attr_reader :city
       # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -33,7 +33,7 @@ module Stripe
       attr_reader :line2
       # ZIP or postal code.
       attr_reader :postal_code
-      # State, county, province, or region.
+      # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
       attr_reader :state
 
       def self.inner_class_types
@@ -45,8 +45,8 @@ module Stripe
       end
     end
 
-    class InvoiceSettings < Stripe::StripeObject
-      class CustomField < Stripe::StripeObject
+    class InvoiceSettings < ::Stripe::StripeObject
+      class CustomField < ::Stripe::StripeObject
         # The name of the custom field.
         attr_reader :name
         # The value of the custom field.
@@ -61,7 +61,7 @@ module Stripe
         end
       end
 
-      class RenderingOptions < Stripe::StripeObject
+      class RenderingOptions < ::Stripe::StripeObject
         # How line-item prices and amounts will be displayed with respect to tax on invoice PDFs.
         attr_reader :amount_tax_display
         # ID of the invoice rendering template to be used for this customer's invoices. If set, the template will be used on all invoices for this customer unless a template is set directly on the invoice.
@@ -93,8 +93,8 @@ module Stripe
       end
     end
 
-    class Shipping < Stripe::StripeObject
-      class Address < Stripe::StripeObject
+    class Shipping < ::Stripe::StripeObject
+      class Address < ::Stripe::StripeObject
         # City, district, suburb, town, or village.
         attr_reader :city
         # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -105,7 +105,7 @@ module Stripe
         attr_reader :line2
         # ZIP or postal code.
         attr_reader :postal_code
-        # State, county, province, or region.
+        # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
         attr_reader :state
 
         def self.inner_class_types
@@ -136,8 +136,8 @@ module Stripe
       end
     end
 
-    class Tax < Stripe::StripeObject
-      class Location < Stripe::StripeObject
+    class Tax < ::Stripe::StripeObject
+      class Location < ::Stripe::StripeObject
         # The identified tax country of the customer.
         attr_reader :country
         # The data source used to infer the customer's location.
@@ -159,6 +159,8 @@ module Stripe
       attr_reader :ip_address
       # The identified tax location of the customer.
       attr_reader :location
+      # The tax calculation provider used for location resolution. Defaults to `stripe` when not using a [third-party provider](/tax/third-party-apps).
+      attr_reader :provider
 
       def self.inner_class_types
         @inner_class_types = { location: Location }
@@ -170,7 +172,7 @@ module Stripe
     end
     # The customer's address.
     attr_reader :address
-    # The current balance, if any, that's stored on the customer in their default currency. If negative, the customer has credit to apply to their next invoice. If positive, the customer has an amount owed that's added to their next invoice. The balance only considers amounts that Stripe hasn't successfully applied to any invoice. It doesn't reflect unpaid invoices. This balance is only taken into account after invoices finalize. For multi-currency balances, see [invoice_credit_balance](https://stripe.com/docs/api/customers/object#customer_object-invoice_credit_balance).
+    # The current balance, if any, that's stored on the customer in their default currency. If negative, the customer has credit to apply to their next invoice. If positive, the customer has an amount owed that's added to their next invoice. The balance only considers amounts that Stripe hasn't successfully applied to any invoice. It doesn't reflect unpaid invoices. This balance is only taken into account after invoices finalize. For multi-currency balances, see [invoice_credit_balance](https://docs.stripe.com/api/customers/object#customer_object-invoice_credit_balance).
     attr_reader :balance
     # The customer's business name.
     attr_reader :business_name
@@ -180,13 +182,15 @@ module Stripe
     attr_reader :created
     # Three-letter [ISO code for the currency](https://stripe.com/docs/currencies) the customer can be charged in for recurring billing purposes.
     attr_reader :currency
+    # The ID of an Account representing a customer. You can use this ID with any v1 API that accepts a customer_account parameter.
+    attr_reader :customer_account
     # ID of the default payment source for the customer.
     #
-    # If you use payment methods created through the PaymentMethods API, see the [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/object#customer_object-invoice_settings-default_payment_method) field instead.
+    # If you use payment methods created through the PaymentMethods API, see the [invoice_settings.default_payment_method](https://docs.stripe.com/api/customers/object#customer_object-invoice_settings-default_payment_method) field instead.
     attr_reader :default_source
     # Tracks the most recent state change on any invoice belonging to the customer. Paying an invoice or marking it uncollectible via the API will set this field to false. An automatic payment failure or passing the `invoice.due_date` will set this field to `true`.
     #
-    # If an invoice becomes uncollectible by [dunning](https://stripe.com/docs/billing/automatic-collection), `delinquent` doesn't reset to `false`.
+    # If an invoice becomes uncollectible by [dunning](https://docs.stripe.com/billing/automatic-collection), `delinquent` doesn't reset to `false`.
     #
     # If you care whether the customer has paid their most recent subscription invoice, use `subscription.status` instead. Paying or marking uncollectible any customer invoice regardless of whether it is the latest invoice for a subscription will always set this field to `false`.
     attr_reader :delinquent
@@ -206,9 +210,9 @@ module Stripe
     attr_reader :invoice_prefix
     # Attribute for field invoice_settings
     attr_reader :invoice_settings
-    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
     attr_reader :livemode
-    # Set of [key-value pairs](https://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.
+    # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
     attr_reader :metadata
     # The customer's full name or business name.
     attr_reader :name
@@ -369,7 +373,7 @@ module Stripe
       search(params, opts).auto_paging_each(&blk)
     end
 
-    # Updates the specified customer by setting the values of the parameters passed. Any parameters not provided will be left unchanged. For example, if you pass the source parameter, that becomes the customer's active source (e.g., a card) to be used for all charges in the future. When you update a customer to a new valid card source by passing the source parameter: for each of the customer's current subscriptions, if the subscription bills automatically and is in the past_due state, then the latest open invoice for the subscription with automatic collection enabled will be retried. This retry will not count as an automatic retry, and will not affect the next regularly scheduled payment for the invoice. Changing the default_source for a customer will not trigger this behavior.
+    # Updates the specified customer by setting the values of the parameters passed. Any parameters not provided are left unchanged. For example, if you pass the source parameter, that becomes the customer's active source (such as a card) to be used for all charges in the future. When you update a customer to a new valid card source by passing the source parameter: for each of the customer's current subscriptions, if the subscription bills automatically and is in the past_due state, then the latest open invoice for the subscription with automatic collection enabled is retried. This retry doesn't count as an automatic retry, and doesn't affect the next regularly scheduled payment for the invoice. Changing the default_source for a customer doesn't trigger this behavior.
     #
     # This request accepts mostly the same arguments as the customer creation call.
     def self.update(customer, params = {}, opts = {})

data/lib/stripe/resources/customer_balance_transaction.rb

@@ -2,12 +2,12 @@
 # frozen_string_literal: true
 
 module Stripe
-  # Each customer has a [Balance](https://stripe.com/docs/api/customers/object#customer_object-balance) value,
+  # Each customer has a [Balance](https://docs.stripe.com/api/customers/object#customer_object-balance) value,
   # which denotes a debit or credit that's automatically applied to their next invoice upon finalization.
-  # You may modify the value directly by using the [update customer API](https://stripe.com/docs/api/customers/update),
+  # You may modify the value directly by using the [update customer API](https://docs.stripe.com/api/customers/update),
   # or by creating a Customer Balance Transaction, which increments or decrements the customer's `balance` by the specified `amount`.
   #
-  # Related guide: [Customer balance](https://stripe.com/docs/billing/customer/balance)
+  # Related guide: [Customer balance](https://docs.stripe.com/billing/customer/balance)
   class CustomerBalanceTransaction < APIResource
     include Stripe::APIOperations::Save
 
@@ -28,6 +28,8 @@ module Stripe
     attr_reader :currency
     # The ID of the customer the transaction belongs to.
     attr_reader :customer
+    # The ID of an Account representing a customer that the transaction belongs to.
+    attr_reader :customer_account
     # An arbitrary string attached to the object. Often useful for displaying to users.
     attr_reader :description
     # The customer's `balance` after the transaction was applied. A negative value decreases the amount due on the customer's next invoice. A positive value increases the amount due on the customer's next invoice.
@@ -36,13 +38,13 @@ module Stripe
     attr_reader :id
     # The ID of the invoice (if any) related to the transaction.
     attr_reader :invoice
-    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
     attr_reader :livemode
-    # Set of [key-value pairs](https://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.
+    # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
     attr_reader :metadata
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object
-    # Transaction type: `adjustment`, `applied_to_invoice`, `credit_note`, `initial`, `invoice_overpaid`, `invoice_too_large`, `invoice_too_small`, `unspent_receiver_credit`, `unapplied_from_invoice`, `checkout_session_subscription_payment`, or `checkout_session_subscription_payment_canceled`. See the [Customer Balance page](https://stripe.com/docs/billing/customer/balance#types) to learn more about transaction types.
+    # Transaction type: `adjustment`, `applied_to_invoice`, `credit_note`, `initial`, `invoice_overpaid`, `invoice_too_large`, `invoice_too_small`, `unspent_receiver_credit`, `unapplied_from_invoice`, `checkout_session_subscription_payment`, or `checkout_session_subscription_payment_canceled`. See the [Customer Balance page](https://docs.stripe.com/billing/customer/balance#types) to learn more about transaction types.
     attr_reader :type
 
     def resource_url

data/lib/stripe/resources/customer_cash_balance_transaction.rb

@@ -12,10 +12,10 @@ module Stripe
       "customer_cash_balance_transaction"
     end
 
-    class AdjustedForOverdraft < Stripe::StripeObject
-      # The [Balance Transaction](https://stripe.com/docs/api/balance_transactions/object) that corresponds to funds taken out of your Stripe balance.
+    class AdjustedForOverdraft < ::Stripe::StripeObject
+      # The [Balance Transaction](https://docs.stripe.com/api/balance_transactions/object) that corresponds to funds taken out of your Stripe balance.
       attr_reader :balance_transaction
-      # The [Cash Balance Transaction](https://stripe.com/docs/api/cash_balance_transactions/object) that brought the customer balance negative, triggering the clawback of funds.
+      # The [Cash Balance Transaction](https://docs.stripe.com/api/cash_balance_transactions/object) that brought the customer balance negative, triggering the clawback of funds.
       attr_reader :linked_transaction
 
       def self.inner_class_types
@@ -27,8 +27,8 @@ module Stripe
       end
     end
 
-    class AppliedToPayment < Stripe::StripeObject
-      # The [Payment Intent](https://stripe.com/docs/api/payment_intents/object) that funds were applied to.
+    class AppliedToPayment < ::Stripe::StripeObject
+      # The [Payment Intent](https://docs.stripe.com/api/payment_intents/object) that funds were applied to.
       attr_reader :payment_intent
 
       def self.inner_class_types
@@ -40,9 +40,9 @@ module Stripe
       end
     end
 
-    class Funded < Stripe::StripeObject
-      class BankTransfer < Stripe::StripeObject
-        class EuBankTransfer < Stripe::StripeObject
+    class Funded < ::Stripe::StripeObject
+      class BankTransfer < ::Stripe::StripeObject
+        class EuBankTransfer < ::Stripe::StripeObject
           # The BIC of the bank of the sender of the funding.
           attr_reader :bic
           # The last 4 digits of the IBAN of the sender of the funding.
@@ -59,7 +59,7 @@ module Stripe
           end
         end
 
-        class GbBankTransfer < Stripe::StripeObject
+        class GbBankTransfer < ::Stripe::StripeObject
           # The last 4 digits of the account number of the sender of the funding.
           attr_reader :account_number_last4
           # The full name of the sender, as supplied by the sending bank.
@@ -76,7 +76,7 @@ module Stripe
           end
         end
 
-        class JpBankTransfer < Stripe::StripeObject
+        class JpBankTransfer < ::Stripe::StripeObject
           # The name of the bank of the sender of the funding.
           attr_reader :sender_bank
           # The name of the bank branch of the sender of the funding.
@@ -93,7 +93,7 @@ module Stripe
           end
         end
 
-        class UsBankTransfer < Stripe::StripeObject
+        class UsBankTransfer < ::Stripe::StripeObject
           # The banking network used for this funding.
           attr_reader :network
           # The full name of the sender, as supplied by the sending bank.
@@ -145,8 +145,8 @@ module Stripe
       end
     end
 
-    class RefundedFromPayment < Stripe::StripeObject
-      # The [Refund](https://stripe.com/docs/api/refunds/object) that moved these funds into the customer's cash balance.
+    class RefundedFromPayment < ::Stripe::StripeObject
+      # The [Refund](https://docs.stripe.com/api/refunds/object) that moved these funds into the customer's cash balance.
       attr_reader :refund
 
       def self.inner_class_types
@@ -158,8 +158,8 @@ module Stripe
       end
     end
 
-    class TransferredToBalance < Stripe::StripeObject
-      # The [Balance Transaction](https://stripe.com/docs/api/balance_transactions/object) that corresponds to funds transferred to your Stripe balance.
+    class TransferredToBalance < ::Stripe::StripeObject
+      # The [Balance Transaction](https://docs.stripe.com/api/balance_transactions/object) that corresponds to funds transferred to your Stripe balance.
       attr_reader :balance_transaction
 
       def self.inner_class_types
@@ -171,8 +171,8 @@ module Stripe
       end
     end
 
-    class UnappliedFromPayment < Stripe::StripeObject
-      # The [Payment Intent](https://stripe.com/docs/api/payment_intents/object) that funds were unapplied from.
+    class UnappliedFromPayment < ::Stripe::StripeObject
+      # The [Payment Intent](https://docs.stripe.com/api/payment_intents/object) that funds were unapplied from.
       attr_reader :payment_intent
 
       def self.inner_class_types
@@ -193,15 +193,17 @@ module Stripe
     attr_reader :currency
     # The customer whose available cash balance changed as a result of this transaction.
     attr_reader :customer
-    # The total available cash balance for the specified currency after this transaction was applied. Represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+    # The ID of an Account representing a customer whose available cash balance changed as a result of this transaction.
+    attr_reader :customer_account
+    # The total available cash balance for the specified currency after this transaction was applied. Represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal).
     attr_reader :ending_balance
     # Attribute for field funded
     attr_reader :funded
     # 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.
+    # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
     attr_reader :livemode
-    # The amount by which the cash balance changed, represented in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). A positive value represents funds being added to the cash balance, a negative value represents funds being removed from the cash balance.
+    # The amount by which the cash balance changed, represented in the [smallest currency unit](https://docs.stripe.com/currencies#zero-decimal). A positive value represents funds being added to the cash balance, a negative value represents funds being removed from the cash balance.
     attr_reader :net_amount
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object
@@ -209,7 +211,7 @@ module Stripe
     attr_reader :refunded_from_payment
     # Attribute for field transferred_to_balance
     attr_reader :transferred_to_balance
-    # The type of the cash balance transaction. New types may be added in future. See [Customer Balance](https://stripe.com/docs/payments/customer-balance#types) to learn more about these types.
+    # The type of the cash balance transaction. New types may be added in future. See [Customer Balance](https://docs.stripe.com/payments/customer-balance#types) to learn more about these types.
     attr_reader :type
     # Attribute for field unapplied_from_payment
     attr_reader :unapplied_from_payment