stripe 15.2.0.pre.beta.1 → 15.2.0

data/lib/stripe/services/checkout/session_service.rb

@@ -42,8 +42,6 @@ module Stripe
         attr_accessor :created
         # Only return the Checkout Sessions for the Customer specified.
         attr_accessor :customer
-        # Only return the Checkout Sessions for the Account specified.
-        attr_accessor :customer_account
         # Only return the Checkout Sessions for the Customer details specified.
         attr_accessor :customer_details
         # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
@@ -66,7 +64,6 @@ module Stripe
         def initialize(
           created: nil,
           customer: nil,
-          customer_account: nil,
           customer_details: nil,
           ending_before: nil,
           expand: nil,
@@ -79,7 +76,6 @@ module Stripe
         )
           @created = created
           @customer = customer
-          @customer_account = customer_account
           @customer_details = customer_details
           @ending_before = ending_before
           @expand = expand
@@ -530,8 +526,6 @@ module Stripe
           attr_accessor :adjustable_quantity
           # The [tax rates](https://stripe.com/docs/api/tax_rates) that will be applied to this line item depending on the customer's billing/shipping address. We currently support the following countries: US, GB, AU, and all countries in the EU.
           attr_accessor :dynamic_tax_rates
-          # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
-          attr_accessor :metadata
           # 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.
@@ -544,7 +538,6 @@ module Stripe
           def initialize(
             adjustable_quantity: nil,
             dynamic_tax_rates: nil,
-            metadata: nil,
             price: nil,
             price_data: nil,
             quantity: nil,
@@ -552,7 +545,6 @@ module Stripe
           )
             @adjustable_quantity = adjustable_quantity
             @dynamic_tax_rates = dynamic_tax_rates
-            @metadata = metadata
             @price = price
             @price_data = price_data
             @quantity = quantity
@@ -966,8 +958,6 @@ module Stripe
             # Installment options for card payments
             attr_accessor :installments
             # Request ability to [capture beyond the standard authorization validity window](/payments/extended-authorization) for this CheckoutSession.
-            attr_accessor :request_decremental_authorization
-            # Request ability to [capture beyond the standard authorization validity window](/payments/extended-authorization) for this CheckoutSession.
             attr_accessor :request_extended_authorization
             # Request ability to [increment the authorization](/payments/incremental-authorization) for this CheckoutSession.
             attr_accessor :request_incremental_authorization
@@ -994,7 +984,6 @@ module Stripe
 
             def initialize(
               installments: nil,
-              request_decremental_authorization: nil,
               request_extended_authorization: nil,
               request_incremental_authorization: nil,
               request_multicapture: nil,
@@ -1006,7 +995,6 @@ module Stripe
               statement_descriptor_suffix_kanji: nil
             )
               @installments = installments
-              @request_decremental_authorization = request_decremental_authorization
               @request_extended_authorization = request_extended_authorization
               @request_incremental_authorization = request_incremental_authorization
               @request_multicapture = request_multicapture
@@ -1322,8 +1310,7 @@ module Stripe
             end
           end
 
-          class PayByBank < Stripe::RequestParams
-          end
+          class PayByBank < Stripe::RequestParams; end
 
           class Payco < Stripe::RequestParams
             # Controls when the funds will be captured from the customer's account.
@@ -1356,8 +1343,6 @@ module Stripe
             attr_accessor :preferred_locale
             # A reference of the PayPal transaction visible to customer which is mapped to PayPal's invoice ID. This must be a globally unique ID if you have configured in your PayPal settings to block multiple payments per invoice ID.
             attr_accessor :reference
-            # A reference of the PayPal transaction visible to customer which is mapped to PayPal's invoice ID. This must be a globally unique ID if you have configured in your PayPal settings to block multiple payments per invoice ID.
-            attr_accessor :reference_id
             # The risk correlation ID for an on-session payment using a saved PayPal payment method.
             attr_accessor :risk_correlation_id
             # Indicates that you intend to make future payments with this PaymentIntent's payment method.
@@ -1370,77 +1355,19 @@ 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
-            # The Stripe connected account IDs of the sellers on the platform for this transaction (optional). Only allowed when [separate charges and transfers](https://stripe.com/docs/connect/separate-charges-and-transfers) are used.
-            attr_accessor :subsellers
 
             def initialize(
               capture_method: nil,
               preferred_locale: nil,
               reference: nil,
-              reference_id: nil,
               risk_correlation_id: nil,
-              setup_future_usage: nil,
-              subsellers: nil
+              setup_future_usage: nil
             )
               @capture_method = capture_method
               @preferred_locale = preferred_locale
               @reference = reference
-              @reference_id = reference_id
               @risk_correlation_id = risk_correlation_id
               @setup_future_usage = setup_future_usage
-              @subsellers = subsellers
-            end
-          end
-
-          class Payto < Stripe::RequestParams
-            class MandateOptions < Stripe::RequestParams
-              # Amount that will be collected. It is required when `amount_type` is `fixed`.
-              attr_accessor :amount
-              # The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.
-              attr_accessor :amount_type
-              # Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date.
-              attr_accessor :end_date
-              # The periodicity at which payments will be collected.
-              attr_accessor :payment_schedule
-              # The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit.
-              attr_accessor :payments_per_period
-              # The purpose for which payments are made. Defaults to retail.
-              attr_accessor :purpose
-              # Date, in YYYY-MM-DD format, from which payments will be collected. Defaults to confirmation time.
-              attr_accessor :start_date
-
-              def initialize(
-                amount: nil,
-                amount_type: nil,
-                end_date: nil,
-                payment_schedule: nil,
-                payments_per_period: nil,
-                purpose: nil,
-                start_date: nil
-              )
-                @amount = amount
-                @amount_type = amount_type
-                @end_date = end_date
-                @payment_schedule = payment_schedule
-                @payments_per_period = payments_per_period
-                @purpose = purpose
-                @start_date = start_date
-              end
-            end
-            # Additional fields for Mandate creation
-            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.
-            #
-            # 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_accessor :setup_future_usage
-
-            def initialize(mandate_options: nil, setup_future_usage: nil)
-              @mandate_options = mandate_options
-              @setup_future_usage = setup_future_usage
             end
           end
 
@@ -1652,8 +1579,6 @@ module Stripe
           attr_accessor :paynow
           # contains details about the PayPal payment method options.
           attr_accessor :paypal
-          # contains details about the PayTo payment method options.
-          attr_accessor :payto
           # contains details about the Pix payment method options.
           attr_accessor :pix
           # contains details about the RevolutPay payment method options.
@@ -1703,7 +1628,6 @@ module Stripe
             payco: nil,
             paynow: nil,
             paypal: nil,
-            payto: nil,
             pix: nil,
             revolut_pay: nil,
             samsung_pay: nil,
@@ -1744,7 +1668,6 @@ module Stripe
             @payco = payco
             @paynow = paynow
             @paypal = paypal
-            @payto = payto
             @pix = pix
             @revolut_pay = revolut_pay
             @samsung_pay = samsung_pay
@@ -1757,33 +1680,6 @@ module Stripe
         end
 
         class Permissions < Stripe::RequestParams
-          class Update < Stripe::RequestParams
-            # Determines which entity is allowed to update the line items.
-            #
-            # Default is `client_only`. Stripe Checkout client will automatically update the line items. If set to `server_only`, only your server is allowed to update the line items.
-            #
-            # When set to `server_only`, you must add the onLineItemsChange event handler when initializing the Stripe Checkout client and manually update the line items from your server using the Stripe API.
-            attr_accessor :line_items
-            # Determines which entity is allowed to update the shipping details.
-            #
-            # Default is `client_only`. Stripe Checkout client will automatically update the shipping details. If set to `server_only`, only your server is allowed to update the shipping details.
-            #
-            # When set to `server_only`, you must add the onShippingDetailsChange event handler when initializing the Stripe Checkout client and manually update the shipping details from your server using the Stripe API.
-            attr_accessor :shipping_details
-
-            def initialize(line_items: nil, shipping_details: nil)
-              @line_items = line_items
-              @shipping_details = shipping_details
-            end
-          end
-          # Permissions for updating the Checkout Session.
-          attr_accessor :update
-          # Determines which entity is allowed to update the line items.
-          #
-          # Default is `client_only`. Stripe Checkout client will automatically update the line items. If set to `server_only`, only your server is allowed to update the line items.
-          #
-          # When set to `server_only`, you must add the onLineItemsChange event handler when initializing the Stripe Checkout client and manually update the line items from your server using the Stripe API.
-          attr_accessor :update_line_items
           # Determines which entity is allowed to update the shipping details.
           #
           # Default is `client_only`. Stripe Checkout client will automatically update the shipping details. If set to `server_only`, only your server is allowed to update the shipping details.
@@ -1791,9 +1687,7 @@ module Stripe
           # When set to `server_only`, you must add the onShippingDetailsChange event handler when initializing the Stripe Checkout client and manually update the shipping details from your server using the Stripe API.
           attr_accessor :update_shipping_details
 
-          def initialize(update: nil, update_line_items: nil, update_shipping_details: nil)
-            @update = update
-            @update_line_items = update_line_items
+          def initialize(update_shipping_details: nil)
             @update_shipping_details = update_shipping_details
           end
         end
@@ -1812,11 +1706,18 @@ module Stripe
         class SavedPaymentMethodOptions < Stripe::RequestParams
           # Uses the `allow_redisplay` value of each saved payment method to filter the set presented to a returning customer. By default, only saved payment methods with ’allow_redisplay: ‘always’ are shown in Checkout.
           attr_accessor :allow_redisplay_filters
+          # Enable customers to choose if they wish to remove their saved payment methods. Disabled by default.
+          attr_accessor :payment_method_remove
           # Enable customers to choose if they wish to save their payment method for future use. Disabled by default.
           attr_accessor :payment_method_save
 
-          def initialize(allow_redisplay_filters: nil, payment_method_save: nil)
+          def initialize(
+            allow_redisplay_filters: nil,
+            payment_method_remove: nil,
+            payment_method_save: nil
+          )
             @allow_redisplay_filters = allow_redisplay_filters
+            @payment_method_remove = payment_method_remove
             @payment_method_save = payment_method_save
           end
         end
@@ -2005,8 +1906,6 @@ module Stripe
           attr_accessor :application_fee_percent
           # A future timestamp to anchor the subscription's billing cycle for new subscriptions.
           attr_accessor :billing_cycle_anchor
-          # Configure billing_mode in each subscription to opt in improved credit proration behavior.
-          attr_accessor :billing_mode
           # The tax rates that will apply to any subscription item that does not have
           # `tax_rates` set. Invoices created will have their `default_tax_rates` populated
           # from the subscription.
@@ -2038,7 +1937,6 @@ module Stripe
           def initialize(
             application_fee_percent: nil,
             billing_cycle_anchor: nil,
-            billing_mode: nil,
             default_tax_rates: nil,
             description: nil,
             invoice_settings: nil,
@@ -2052,7 +1950,6 @@ module Stripe
           )
             @application_fee_percent = application_fee_percent
             @billing_cycle_anchor = billing_cycle_anchor
-            @billing_mode = billing_mode
             @default_tax_rates = default_tax_rates
             @description = description
             @invoice_settings = invoice_settings
@@ -2130,8 +2027,6 @@ module Stripe
         #
         # You can set [`payment_intent_data.setup_future_usage`](https://stripe.com/docs/api/checkout/sessions/create#create_checkout_session-payment_intent_data-setup_future_usage) to have Checkout automatically attach the payment method to the Customer you pass in for future reuse.
         attr_accessor :customer
-        # ID of an existing Account, if one exists. Has the same behavior as `customer`.
-        attr_accessor :customer_account
         # Configure whether a Checkout Session creates a [Customer](https://stripe.com/docs/api/customers) during Session confirmation.
         #
         # When a Customer is not created, you can still retrieve email, address, and other customer data entered in Checkout
@@ -2261,7 +2156,6 @@ module Stripe
           custom_fields: nil,
           custom_text: nil,
           customer: nil,
-          customer_account: nil,
           customer_creation: nil,
           customer_email: nil,
           customer_update: nil,
@@ -2307,7 +2201,6 @@ module Stripe
           @custom_fields = custom_fields
           @custom_text = custom_text
           @customer = customer
-          @customer_account = customer_account
           @customer_creation = customer_creation
           @customer_email = customer_email
           @customer_update = customer_update
@@ -2403,122 +2296,6 @@ module Stripe
           end
         end
 
-        class LineItem < Stripe::RequestParams
-          class AdjustableQuantity < Stripe::RequestParams
-            # Set to true if the quantity can be adjusted to any positive integer. Setting to false will remove any previously specified constraints on quantity.
-            attr_accessor :enabled
-            # The maximum quantity the customer can purchase for the Checkout Session. By default this value is 99. You can specify a value up to 999999.
-            attr_accessor :maximum
-            # The minimum quantity the customer must purchase for the Checkout Session. By default this value is 0.
-            attr_accessor :minimum
-
-            def initialize(enabled: nil, maximum: nil, minimum: nil)
-              @enabled = enabled
-              @maximum = maximum
-              @minimum = minimum
-            end
-          end
-
-          class PriceData < Stripe::RequestParams
-            class ProductData < Stripe::RequestParams
-              # The product's description, meant to be displayable to the customer. Use this field to optionally store a long form explanation of the product being sold for your own rendering purposes.
-              attr_accessor :description
-              # A list of up to 8 URLs of images for this product, meant to be displayable to the customer.
-              attr_accessor :images
-              # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
-              attr_accessor :metadata
-              # The product's name, meant to be displayable to the customer.
-              attr_accessor :name
-              # A [tax code](https://stripe.com/docs/tax/tax-categories) ID.
-              attr_accessor :tax_code
-
-              def initialize(description: nil, images: nil, metadata: nil, name: nil, tax_code: nil)
-                @description = description
-                @images = images
-                @metadata = metadata
-                @name = name
-                @tax_code = tax_code
-              end
-            end
-
-            class Recurring < Stripe::RequestParams
-              # Specifies billing frequency. Either `day`, `week`, `month` or `year`.
-              attr_accessor :interval
-              # The number of intervals between subscription billings. For example, `interval=month` and `interval_count=3` bills every 3 months. Maximum of three years interval allowed (3 years, 36 months, or 156 weeks).
-              attr_accessor :interval_count
-
-              def initialize(interval: nil, interval_count: nil)
-                @interval = interval
-                @interval_count = interval_count
-              end
-            end
-            # 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
-            # The ID of the [Product](https://docs.stripe.com/api/products) that this [Price](https://docs.stripe.com/api/prices) will belong to. One of `product` or `product_data` is required.
-            attr_accessor :product
-            # Data used to generate a new [Product](https://docs.stripe.com/api/products) object inline. One of `product` or `product_data` is required.
-            attr_accessor :product_data
-            # The recurring components of a price such as `interval` and `interval_count`.
-            attr_accessor :recurring
-            # Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
-            attr_accessor :tax_behavior
-            # A non-negative integer in cents (or local equivalent) representing how much to charge. One of `unit_amount` or `unit_amount_decimal` is required.
-            attr_accessor :unit_amount
-            # Same as `unit_amount`, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one of `unit_amount` and `unit_amount_decimal` can be set.
-            attr_accessor :unit_amount_decimal
-
-            def initialize(
-              currency: nil,
-              product: nil,
-              product_data: nil,
-              recurring: nil,
-              tax_behavior: nil,
-              unit_amount: nil,
-              unit_amount_decimal: nil
-            )
-              @currency = currency
-              @product = product
-              @product_data = product_data
-              @recurring = recurring
-              @tax_behavior = tax_behavior
-              @unit_amount = unit_amount
-              @unit_amount_decimal = unit_amount_decimal
-            end
-          end
-          # When set, provides configuration for this item’s quantity to be adjusted by the customer during Checkout.
-          attr_accessor :adjustable_quantity
-          # ID of an existing line item.
-          attr_accessor :id
-          # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
-          attr_accessor :metadata
-          # The ID of the [Price](https://stripe.com/docs/api/prices). One of `price` or `price_data` is required when creating a new line item.
-          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 when creating a new line item.
-          attr_accessor :price_data
-          # The quantity of the line item being purchased.
-          attr_accessor :quantity
-          # The [tax rates](https://stripe.com/docs/api/tax_rates) which apply to this line item.
-          attr_accessor :tax_rates
-
-          def initialize(
-            adjustable_quantity: nil,
-            id: nil,
-            metadata: nil,
-            price: nil,
-            price_data: nil,
-            quantity: nil,
-            tax_rates: nil
-          )
-            @adjustable_quantity = adjustable_quantity
-            @id = id
-            @metadata = metadata
-            @price = price
-            @price_data = price_data
-            @quantity = quantity
-            @tax_rates = tax_rates
-          end
-        end
-
         class ShippingOption < Stripe::RequestParams
           class ShippingRateData < Stripe::RequestParams
             class DeliveryEstimate < Stripe::RequestParams
@@ -2628,20 +2405,6 @@ module Stripe
         attr_accessor :collected_information
         # Specifies which fields in the response should be expanded.
         attr_accessor :expand
-        # A list of items the customer is purchasing.
-        #
-        # When updating line items, you must retransmit the entire array of line items.
-        #
-        # To retain an existing line item, specify its `id`.
-        #
-        # To update an existing line item, specify its `id` along with the new values of the fields to update.
-        #
-        # To add a new line item, specify a `price` and `quantity`.
-        #
-        # To remove an existing line item, omit the line item's ID from the retransmitted array.
-        #
-        # To reorder a line item, specify it at the desired position in the retransmitted array.
-        attr_accessor :line_items
         # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
         attr_accessor :metadata
         # The shipping rate options to apply to this Session. Up to a maximum of 5.
@@ -2650,13 +2413,11 @@ module Stripe
         def initialize(
           collected_information: nil,
           expand: nil,
-          line_items: nil,
           metadata: nil,
           shipping_options: nil
         )
           @collected_information = collected_information
           @expand = expand
-          @line_items = line_items
           @metadata = metadata
           @shipping_options = shipping_options
         end
@@ -2718,6 +2479,8 @@ module Stripe
       end
 
       # Updates a Checkout Session object.
+      #
+      # Related guide: [Dynamically update Checkout](https://docs.stripe.com/payments/checkout/dynamic-updates)
       def update(session, params = {}, opts = {})
         request(
           method: :post,

data/lib/stripe/services/coupon_service.rb

@@ -3,8 +3,7 @@
 
 module Stripe
   class CouponService < StripeService
-    class DeleteParams < Stripe::RequestParams
-    end
+    class DeleteParams < Stripe::RequestParams; end
 
     class RetrieveParams < Stripe::RequestParams
       # Specifies which fields in the response should be expanded.
@@ -97,18 +96,6 @@ module Stripe
           @amount_off = amount_off
         end
       end
-
-      class Script < Stripe::RequestParams
-        # The configuration values of the script. The keys and values are specific to the script implementation.
-        attr_accessor :configuration
-        # The script implementation ID for this coupon.
-        attr_accessor :id
-
-        def initialize(configuration: nil, id: nil)
-          @configuration = configuration
-          @id = id
-        end
-      end
       # A positive integer representing the amount to subtract from an invoice total (required if `percent_off` is not passed).
       attr_accessor :amount_off
       # A hash containing directions for what this Coupon will apply discounts to.
@@ -135,8 +122,6 @@ module Stripe
       attr_accessor :percent_off
       # Unix timestamp specifying the last time at which the coupon can be redeemed. After the redeem_by date, the coupon can no longer be applied to new customers.
       attr_accessor :redeem_by
-      # Configuration of the [script](https://docs.stripe.com/billing/subscriptions/script-coupons) used to calculate the discount.
-      attr_accessor :script
 
       def initialize(
         amount_off: nil,
@@ -151,8 +136,7 @@ module Stripe
         metadata: nil,
         name: nil,
         percent_off: nil,
-        redeem_by: nil,
-        script: nil
+        redeem_by: nil
       )
         @amount_off = amount_off
         @applies_to = applies_to
@@ -167,7 +151,6 @@ module Stripe
         @name = name
         @percent_off = percent_off
         @redeem_by = redeem_by
-        @script = script
       end
     end
 

data/lib/stripe/services/credit_note_service.rb

@@ -33,8 +33,6 @@ module Stripe
       attr_accessor :created
       # Only return credit notes for the customer specified by this customer ID.
       attr_accessor :customer
-      # Only return credit notes for the account specified by this account ID.
-      attr_accessor :customer_account
       # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
       attr_accessor :ending_before
       # Specifies which fields in the response should be expanded.
@@ -49,7 +47,6 @@ module Stripe
       def initialize(
         created: nil,
         customer: nil,
-        customer_account: nil,
         ending_before: nil,
         expand: nil,
         invoice: nil,
@@ -58,7 +55,6 @@ module Stripe
       )
         @created = created
         @customer = customer
-        @customer_account = customer_account
         @ending_before = ending_before
         @expand = expand
         @invoice = invoice
@@ -380,20 +376,19 @@ module Stripe
       end
     end
 
-    # Issue a credit note to adjust the amount of a finalized invoice. For a status=open invoice, a credit note reduces
-    # its amount_due. For a status=paid invoice, a credit note does not affect its amount_due. Instead, it can result
-    # in any combination of the following:
+    # Issue a credit note to adjust the amount of a finalized invoice. A credit note will first reduce the invoice's amount_remaining (and amount_due), but not below zero.
+    # This amount is indicated by the credit note's pre_payment_amount. The excess amount is indicated by post_payment_amount, and it can result in any combination of the following:
     #
     #
-    # Refund: create a new refund (using refund_amount) or link an existing refund (using refund).
+    # Refunds: create a new refund (using refund_amount) or link existing refunds (using refunds).
     # Customer balance credit: credit the customer's balance (using credit_amount) which will be automatically applied to their next invoice when it's finalized.
     # Outside of Stripe credit: record the amount that is or will be credited outside of Stripe (using out_of_band_amount).
     #
     #
-    # For post-payment credit notes the sum of the refund, credit and outside of Stripe amounts must equal the credit note total.
+    # The sum of refunds, customer balance credits, and outside of Stripe credits must equal the post_payment_amount.
     #
-    # You may issue multiple credit notes for an invoice. Each credit note will increment the invoice's pre_payment_credit_notes_amount
-    # or post_payment_credit_notes_amount depending on its status at the time of credit note creation.
+    # You may issue multiple credit notes for an invoice. Each credit note may increment the invoice's pre_payment_credit_notes_amount,
+    # post_payment_credit_notes_amount, or both, depending on the invoice's amount_remaining at the time of credit note creation.
     def create(params = {}, opts = {})
       request(
         method: :post,
@@ -448,7 +443,7 @@ module Stripe
       )
     end
 
-    # Marks a credit note as void. Learn more about [voiding credit notes](https://stripe.com/docs/billing/invoices/credit-notes#voiding).
+    # Marks a credit note as void. Learn more about [voiding credit notes](https://docs.stripe.com/docs/billing/invoices/credit-notes#voiding).
     def void_credit_note(id, params = {}, opts = {})
       request(
         method: :post,

data/lib/stripe/services/customer_balance_transaction_service.rb

@@ -66,7 +66,7 @@ module Stripe
       end
     end
 
-    # Creates an immutable transaction that updates the customer's credit [balance](https://stripe.com/docs/billing/customer/balance).
+    # Creates an immutable transaction that updates the customer's credit [balance](https://docs.stripe.com/docs/billing/customer/balance).
     def create(customer, params = {}, opts = {})
       request(
         method: :post,
@@ -77,7 +77,7 @@ module Stripe
       )
     end
 
-    # Returns a list of transactions that updated the customer's [balances](https://stripe.com/docs/billing/customer/balance).
+    # Returns a list of transactions that updated the customer's [balances](https://docs.stripe.com/docs/billing/customer/balance).
     def list(customer, params = {}, opts = {})
       request(
         method: :get,
@@ -88,7 +88,7 @@ module Stripe
       )
     end
 
-    # Retrieves a specific customer balance transaction that updated the customer's [balances](https://stripe.com/docs/billing/customer/balance).
+    # Retrieves a specific customer balance transaction that updated the customer's [balances](https://docs.stripe.com/docs/billing/customer/balance).
     def retrieve(customer, transaction, params = {}, opts = {})
       request(
         method: :get,

data/lib/stripe/services/customer_cash_balance_transaction_service.rb

@@ -30,7 +30,7 @@ module Stripe
       end
     end
 
-    # Returns a list of transactions that modified the customer's [cash balance](https://stripe.com/docs/payments/customer-balance).
+    # Returns a list of transactions that modified the customer's [cash balance](https://docs.stripe.com/docs/payments/customer-balance).
     def list(customer, params = {}, opts = {})
       request(
         method: :get,
@@ -41,7 +41,7 @@ module Stripe
       )
     end
 
-    # Retrieves a specific cash balance transaction, which updated the customer's [cash balance](https://stripe.com/docs/payments/customer-balance).
+    # Retrieves a specific cash balance transaction, which updated the customer's [cash balance](https://docs.stripe.com/docs/payments/customer-balance).
     def retrieve(customer, transaction, params = {}, opts = {})
       request(
         method: :get,

data/lib/stripe/services/customer_payment_source_service.rb

@@ -186,7 +186,7 @@ module Stripe
     #
     # If the card's owner has no default card, then the new card will become the default.
     # However, if the owner already has a default, then it will not change.
-    # To change the default, you should [update the customer](https://stripe.com/docs/api#update_customer) to have a new default_source.
+    # To change the default, you should [update the customer](https://docs.stripe.com/docs/api#update_customer) to have a new default_source.
     def create(customer, params = {}, opts = {})
       request(
         method: :post,