stripe 15.0.0 → 15.3.0

data/lib/stripe/resources/confirmation_token.rb

@@ -34,8 +34,23 @@ module Stripe
 
     class PaymentMethodOptions < Stripe::StripeObject
       class Card < Stripe::StripeObject
+        class Installments < Stripe::StripeObject
+          class Plan < Stripe::StripeObject
+            # For `fixed_count` installment plans, this is the number of installment payments your customer will make to their credit card.
+            attr_reader :count
+            # For `fixed_count` installment plans, this is the interval between installment payments your customer will make to their credit card.
+            # One of `month`.
+            attr_reader :interval
+            # Type of installment plan, one of `fixed_count`, `bonus`, or `revolving`.
+            attr_reader :type
+          end
+          # Attribute for field plan
+          attr_reader :plan
+        end
         # The `cvc_update` Token collected from the Payment Element.
         attr_reader :cvc_token
+        # Installment configuration for payments.
+        attr_reader :installments
       end
       # This hash contains the card payment method options.
       attr_reader :card
@@ -105,6 +120,8 @@ module Stripe
         attr_reader :name
         # Billing phone number (including extension).
         attr_reader :phone
+        # Taxpayer identification number. Used only for transactions between LATAM buyers and non-LATAM sellers.
+        attr_reader :tax_id
       end
 
       class Blik < Stripe::StripeObject; end
@@ -137,9 +154,9 @@ module Stripe
               class Receipt < Stripe::StripeObject
                 # The type of account being debited or credited
                 attr_reader :account_type
-                # EMV tag 9F26, cryptogram generated by the integrated circuit chip.
+                # The Application Cryptogram, a unique value generated by the card to authenticate the transaction with issuers.
                 attr_reader :application_cryptogram
-                # Mnenomic of the Application Identifier.
+                # The Application Identifier (AID) on the card used to determine which networks are eligible to process the transaction. Referenced from EMV tag 9F12, data encoded on the card's chip.
                 attr_reader :application_preferred_name
                 # Identifier for this transaction.
                 attr_reader :authorization_code
@@ -147,11 +164,11 @@ module Stripe
                 attr_reader :authorization_response_code
                 # Describes the method used by the cardholder to verify ownership of the card. One of the following: `approval`, `failure`, `none`, `offline_pin`, `offline_pin_and_signature`, `online_pin`, or `signature`.
                 attr_reader :cardholder_verification_method
-                # EMV tag 84. Similar to the application identifier stored on the integrated circuit chip.
+                # Similar to the application_preferred_name, identifying the applications (AIDs) available on the card. Referenced from EMV tag 84.
                 attr_reader :dedicated_file_name
-                # The outcome of a series of EMV functions performed by the card reader.
+                # A 5-byte string that records the checks and validations that occur between the card and the terminal. These checks determine how the terminal processes the transaction and what risk tolerance is acceptable. Referenced from EMV Tag 95.
                 attr_reader :terminal_verification_results
-                # An indication of various EMV functions performed during the transaction.
+                # An indication of which steps were completed during the card read process. Referenced from EMV Tag 9B.
                 attr_reader :transaction_status_information
               end
 
@@ -203,7 +220,7 @@ module Stripe
               attr_reader :offline
               # Defines whether the authorized amount can be over-captured or not
               attr_reader :overcapture_supported
-              # EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
+              # The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card's chip.
               attr_reader :preferred_locales
               # How card details were read in this transaction.
               attr_reader :read_method
@@ -430,7 +447,7 @@ module Stripe
         attr_reader :networks
         # Details about payment methods collected offline.
         attr_reader :offline
-        # EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
+        # The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card's chip.
         attr_reader :preferred_locales
         # How card details were read in this transaction.
         attr_reader :read_method
@@ -445,6 +462,7 @@ module Stripe
         attr_reader :cashtag
       end
 
+      class Crypto < Stripe::StripeObject; end
       class CustomerBalance < Stripe::StripeObject; end
 
       class Eps < Stripe::StripeObject
@@ -463,7 +481,7 @@ module Stripe
       class Grabpay < Stripe::StripeObject; end
 
       class Ideal < Stripe::StripeObject
-        # The customer's bank, if provided. Can be one of `abn_amro`, `asn_bank`, `bunq`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
+        # The customer's bank, if provided. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
         attr_reader :bank
         # The Bank Identifier Code of the customer's bank, if the bank was provided.
         attr_reader :bic
@@ -502,7 +520,7 @@ module Stripe
         attr_reader :last4
         # Contains information about card networks that can be used to process the payment.
         attr_reader :networks
-        # EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
+        # The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card's chip.
         attr_reader :preferred_locales
         # How card details were read in this transaction.
         attr_reader :read_method
@@ -694,6 +712,8 @@ module Stripe
       attr_reader :card_present
       # Attribute for field cashapp
       attr_reader :cashapp
+      # Attribute for field crypto
+      attr_reader :crypto
       # The ID of the Customer to which this PaymentMethod is saved. This will not be set when the PaymentMethod has not been saved to a Customer.
       attr_reader :customer
       # Attribute for field customer_balance
@@ -808,20 +828,11 @@ module Stripe
           end
         end
 
-        class Affirm < Stripe::RequestParams
-        end
-
-        class AfterpayClearpay < Stripe::RequestParams
-        end
-
-        class Alipay < Stripe::RequestParams
-        end
-
-        class Alma < Stripe::RequestParams
-        end
-
-        class AmazonPay < Stripe::RequestParams
-        end
+        class Affirm < Stripe::RequestParams; end
+        class AfterpayClearpay < Stripe::RequestParams; end
+        class Alipay < Stripe::RequestParams; end
+        class Alma < Stripe::RequestParams; end
+        class AmazonPay < Stripe::RequestParams; end
 
         class AuBecsDebit < Stripe::RequestParams
           # The account number for the bank account.
@@ -847,11 +858,8 @@ module Stripe
           end
         end
 
-        class Bancontact < Stripe::RequestParams
-        end
-
-        class Billie < Stripe::RequestParams
-        end
+        class Bancontact < Stripe::RequestParams; end
+        class Billie < Stripe::RequestParams; end
 
         class BillingDetails < Stripe::RequestParams
           class Address < Stripe::RequestParams
@@ -892,17 +900,19 @@ module Stripe
           attr_accessor :name
           # Billing phone number (including extension).
           attr_accessor :phone
+          # Taxpayer identification number. Used only for transactions between LATAM buyers and non-LATAM sellers.
+          attr_accessor :tax_id
 
-          def initialize(address: nil, email: nil, name: nil, phone: nil)
+          def initialize(address: nil, email: nil, name: nil, phone: nil, tax_id: nil)
             @address = address
             @email = email
             @name = name
             @phone = phone
+            @tax_id = tax_id
           end
         end
 
-        class Blik < Stripe::RequestParams
-        end
+        class Blik < Stripe::RequestParams; end
 
         class Boleto < Stripe::RequestParams
           # The tax ID of the customer (CPF for individual consumers or CNPJ for businesses consumers)
@@ -913,11 +923,9 @@ module Stripe
           end
         end
 
-        class Cashapp < Stripe::RequestParams
-        end
-
-        class CustomerBalance < Stripe::RequestParams
-        end
+        class Cashapp < Stripe::RequestParams; end
+        class Crypto < Stripe::RequestParams; end
+        class CustomerBalance < Stripe::RequestParams; end
 
         class Eps < Stripe::RequestParams
           # The customer's bank.
@@ -940,11 +948,8 @@ module Stripe
           end
         end
 
-        class Giropay < Stripe::RequestParams
-        end
-
-        class Grabpay < Stripe::RequestParams
-        end
+        class Giropay < Stripe::RequestParams; end
+        class Grabpay < Stripe::RequestParams; end
 
         class Ideal < Stripe::RequestParams
           # The customer's bank. Only use this parameter for existing customers. Don't use it for new customers.
@@ -955,11 +960,8 @@ module Stripe
           end
         end
 
-        class InteracPresent < Stripe::RequestParams
-        end
-
-        class KakaoPay < Stripe::RequestParams
-        end
+        class InteracPresent < Stripe::RequestParams; end
+        class KakaoPay < Stripe::RequestParams; end
 
         class Klarna < Stripe::RequestParams
           class Dob < Stripe::RequestParams
@@ -984,20 +986,11 @@ module Stripe
           end
         end
 
-        class Konbini < Stripe::RequestParams
-        end
-
-        class KrCard < Stripe::RequestParams
-        end
-
-        class Link < Stripe::RequestParams
-        end
-
-        class Mobilepay < Stripe::RequestParams
-        end
-
-        class Multibanco < Stripe::RequestParams
-        end
+        class Konbini < Stripe::RequestParams; end
+        class KrCard < Stripe::RequestParams; end
+        class Link < Stripe::RequestParams; end
+        class Mobilepay < Stripe::RequestParams; end
+        class Multibanco < Stripe::RequestParams; end
 
         class NaverPay < Stripe::RequestParams
           # Whether to use Naver Pay points or a card to fund this transaction. If not provided, this defaults to `card`.
@@ -1039,8 +1032,7 @@ module Stripe
           end
         end
 
-        class Oxxo < Stripe::RequestParams
-        end
+        class Oxxo < Stripe::RequestParams; end
 
         class P24 < Stripe::RequestParams
           # The customer's bank.
@@ -1051,23 +1043,12 @@ module Stripe
           end
         end
 
-        class PayByBank < Stripe::RequestParams
-        end
-
-        class Payco < Stripe::RequestParams
-        end
-
-        class Paynow < Stripe::RequestParams
-        end
-
-        class Paypal < Stripe::RequestParams
-        end
-
-        class Pix < Stripe::RequestParams
-        end
-
-        class Promptpay < Stripe::RequestParams
-        end
+        class PayByBank < Stripe::RequestParams; end
+        class Payco < Stripe::RequestParams; end
+        class Paynow < Stripe::RequestParams; end
+        class Paypal < Stripe::RequestParams; end
+        class Pix < Stripe::RequestParams; end
+        class Promptpay < Stripe::RequestParams; end
 
         class RadarOptions < Stripe::RequestParams
           # A [Radar Session](https://stripe.com/docs/radar/radar-session) is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments.
@@ -1078,14 +1059,9 @@ module Stripe
           end
         end
 
-        class RevolutPay < Stripe::RequestParams
-        end
-
-        class SamsungPay < Stripe::RequestParams
-        end
-
-        class Satispay < Stripe::RequestParams
-        end
+        class RevolutPay < Stripe::RequestParams; end
+        class SamsungPay < Stripe::RequestParams; end
+        class Satispay < Stripe::RequestParams; end
 
         class SepaDebit < Stripe::RequestParams
           # IBAN of the bank account.
@@ -1105,11 +1081,8 @@ module Stripe
           end
         end
 
-        class Swish < Stripe::RequestParams
-        end
-
-        class Twint < Stripe::RequestParams
-        end
+        class Swish < Stripe::RequestParams; end
+        class Twint < Stripe::RequestParams; end
 
         class UsBankAccount < Stripe::RequestParams
           # Account holder type: individual or company.
@@ -1138,11 +1111,8 @@ module Stripe
           end
         end
 
-        class WechatPay < Stripe::RequestParams
-        end
-
-        class Zip < Stripe::RequestParams
-        end
+        class WechatPay < Stripe::RequestParams; end
+        class Zip < Stripe::RequestParams; end
         # If this is an `acss_debit` PaymentMethod, this hash contains details about the ACSS Debit payment method.
         attr_accessor :acss_debit
         # If this is an `affirm` PaymentMethod, this hash contains details about the Affirm payment method.
@@ -1163,7 +1133,7 @@ module Stripe
         attr_accessor :bacs_debit
         # If this is a `bancontact` PaymentMethod, this hash contains details about the Bancontact payment method.
         attr_accessor :bancontact
-        # If this is a `billie` PaymentMethod, this hash contains details about the billie payment method.
+        # If this is a `billie` PaymentMethod, this hash contains details about the Billie payment method.
         attr_accessor :billie
         # Billing information associated with the PaymentMethod that may be used or required by particular types of payment methods.
         attr_accessor :billing_details
@@ -1173,6 +1143,8 @@ module Stripe
         attr_accessor :boleto
         # If this is a `cashapp` PaymentMethod, this hash contains details about the Cash App Pay payment method.
         attr_accessor :cashapp
+        # If this is a Crypto PaymentMethod, this hash contains details about the Crypto payment method.
+        attr_accessor :crypto
         # If this is a `customer_balance` PaymentMethod, this hash contains details about the CustomerBalance payment method.
         attr_accessor :customer_balance
         # If this is an `eps` PaymentMethod, this hash contains details about the EPS payment method.
@@ -1225,11 +1197,11 @@ module Stripe
         attr_accessor :promptpay
         # Options to configure Radar. See [Radar Session](https://stripe.com/docs/radar/radar-session) for more information.
         attr_accessor :radar_options
-        # If this is a `Revolut Pay` PaymentMethod, this hash contains details about the Revolut Pay payment method.
+        # If this is a `revolut_pay` PaymentMethod, this hash contains details about the Revolut Pay payment method.
         attr_accessor :revolut_pay
         # If this is a `samsung_pay` PaymentMethod, this hash contains details about the SamsungPay payment method.
         attr_accessor :samsung_pay
-        # If this is a `satispay` PaymentMethod, this hash contains details about the satispay payment method.
+        # If this is a `satispay` PaymentMethod, this hash contains details about the Satispay payment method.
         attr_accessor :satispay
         # If this is a `sepa_debit` PaymentMethod, this hash contains details about the SEPA debit bank account.
         attr_accessor :sepa_debit
@@ -1264,6 +1236,7 @@ module Stripe
           blik: nil,
           boleto: nil,
           cashapp: nil,
+          crypto: nil,
           customer_balance: nil,
           eps: nil,
           fpx: nil,
@@ -1317,6 +1290,7 @@ module Stripe
           @blik = blik
           @boleto = boleto
           @cashapp = cashapp
+          @crypto = crypto
           @customer_balance = customer_balance
           @eps = eps
           @fpx = fpx
@@ -1357,6 +1331,47 @@ module Stripe
         end
       end
 
+      class PaymentMethodOptions < Stripe::RequestParams
+        class Card < Stripe::RequestParams
+          class Installments < Stripe::RequestParams
+            class Plan < Stripe::RequestParams
+              # For `fixed_count` installment plans, this is required. It represents the number of installment payments your customer will make to their credit card.
+              attr_accessor :count
+              # For `fixed_count` installment plans, this is required. It represents the interval between installment payments your customer will make to their credit card.
+              # One of `month`.
+              attr_accessor :interval
+              # Type of installment plan, one of `fixed_count`, `bonus`, or `revolving`.
+              attr_accessor :type
+
+              def initialize(count: nil, interval: nil, type: nil)
+                @count = count
+                @interval = interval
+                @type = type
+              end
+            end
+            # The selected installment plan to use for this payment attempt.
+            # This parameter can only be provided during confirmation.
+            attr_accessor :plan
+
+            def initialize(plan: nil)
+              @plan = plan
+            end
+          end
+          # Installment configuration for payments confirmed using this ConfirmationToken.
+          attr_accessor :installments
+
+          def initialize(installments: nil)
+            @installments = installments
+          end
+        end
+        # Configuration for any card payments confirmed using this ConfirmationToken.
+        attr_accessor :card
+
+        def initialize(card: nil)
+          @card = card
+        end
+      end
+
       class Shipping < Stripe::RequestParams
         class Address < Stripe::RequestParams
           # City, district, suburb, town, or village.
@@ -1407,6 +1422,8 @@ module Stripe
       attr_accessor :payment_method
       # If provided, this hash will be used to create a PaymentMethod.
       attr_accessor :payment_method_data
+      # Payment-method-specific configuration for this ConfirmationToken.
+      attr_accessor :payment_method_options
       # Return URL used to confirm the Intent.
       attr_accessor :return_url
       # Indicates that you intend to make future payments with this ConfirmationToken's payment method.
@@ -1420,6 +1437,7 @@ module Stripe
         expand: nil,
         payment_method: nil,
         payment_method_data: nil,
+        payment_method_options: nil,
         return_url: nil,
         setup_future_usage: nil,
         shipping: nil
@@ -1427,6 +1445,7 @@ module Stripe
         @expand = expand
         @payment_method = payment_method
         @payment_method_data = payment_method_data
+        @payment_method_options = payment_method_options
         @return_url = return_url
         @setup_future_usage = setup_future_usage
         @shipping = shipping

data/lib/stripe/resources/country_spec.rb

@@ -7,7 +7,7 @@ module Stripe
   # Country Specs API makes these rules available to your integration.
   #
   # You can also view the information from this API call as [an online
-  # guide](https://stripe.com/docs/connect/required-verification-information).
+  # guide](https://docs.stripe.com/docs/connect/required-verification-information).
   class CountrySpec < APIResource
     extend Stripe::APIOperations::List
 

data/lib/stripe/resources/coupon.rb

@@ -26,8 +26,7 @@ module Stripe
       attr_reader :amount_off
     end
 
-    class DeleteParams < Stripe::RequestParams
-    end
+    class DeleteParams < Stripe::RequestParams; end
 
     class UpdateParams < Stripe::RequestParams
       class CurrencyOptions < Stripe::RequestParams
@@ -178,7 +177,7 @@ module Stripe
     attr_reader :currency
     # Coupons defined in each available currency option. Each key must be a three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html) and a [supported currency](https://stripe.com/docs/currencies).
     attr_reader :currency_options
-    # One of `forever`, `once`, and `repeating`. Describes how long a customer who applies this coupon will get the discount.
+    # One of `forever`, `once`, or `repeating`. Describes how long a customer who applies this coupon will get the discount.
     attr_reader :duration
     # If `duration` is `repeating`, the number of months the coupon applies. Null if coupon `duration` is `forever` or `once`.
     attr_reader :duration_in_months

data/lib/stripe/resources/credit_note.rb

@@ -214,7 +214,7 @@ module Stripe
           @shipping_rate = shipping_rate
         end
       end
-      # The integer amount in cents (or local equivalent) representing the total amount of the credit note.
+      # The integer amount in cents (or local equivalent) representing the total amount of the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :amount
       # The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
       attr_accessor :credit_amount
@@ -226,7 +226,7 @@ module Stripe
       attr_accessor :expand
       # ID of the invoice.
       attr_accessor :invoice
-      # Line items that make up the credit note.
+      # Line items that make up the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :lines
       # The credit note's memo appears on the credit note PDF.
       attr_accessor :memo
@@ -240,7 +240,7 @@ module Stripe
       attr_accessor :refund_amount
       # Refunds to link to this credit note.
       attr_accessor :refunds
-      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
+      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :shipping_cost
 
       def initialize(
@@ -369,7 +369,7 @@ module Stripe
           @shipping_rate = shipping_rate
         end
       end
-      # The integer amount in cents (or local equivalent) representing the total amount of the credit note.
+      # The integer amount in cents (or local equivalent) representing the total amount of the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :amount
       # The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
       attr_accessor :credit_amount
@@ -381,7 +381,7 @@ module Stripe
       attr_accessor :expand
       # ID of the invoice.
       attr_accessor :invoice
-      # Line items that make up the credit note.
+      # Line items that make up the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :lines
       # The credit note's memo appears on the credit note PDF.
       attr_accessor :memo
@@ -395,7 +395,7 @@ module Stripe
       attr_accessor :refund_amount
       # Refunds to link to this credit note.
       attr_accessor :refunds
-      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
+      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :shipping_cost
 
       def initialize(
@@ -509,7 +509,7 @@ module Stripe
           @shipping_rate = shipping_rate
         end
       end
-      # The integer amount in cents (or local equivalent) representing the total amount of the credit note.
+      # The integer amount in cents (or local equivalent) representing the total amount of the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :amount
       # The integer amount in cents (or local equivalent) representing the amount to credit the customer's balance, which will be automatically applied to their next invoice.
       attr_accessor :credit_amount
@@ -525,7 +525,7 @@ module Stripe
       attr_accessor :invoice
       # A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
       attr_accessor :limit
-      # Line items that make up the credit note.
+      # Line items that make up the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :lines
       # The credit note's memo appears on the credit note PDF.
       attr_accessor :memo
@@ -539,7 +539,7 @@ module Stripe
       attr_accessor :refund_amount
       # Refunds to link to this credit note.
       attr_accessor :refunds
-      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
+      # When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note. One of `amount`, `lines`, or `shipping_cost` must be provided.
       attr_accessor :shipping_cost
       # A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.
       attr_accessor :starting_after
@@ -629,6 +629,10 @@ module Stripe
     attr_reader :out_of_band_amount
     # The link to download the PDF of the credit note.
     attr_reader :pdf
+    # The amount of the credit note that was refunded to the customer, credited to the customer's balance, credited outside of Stripe, or any combination thereof.
+    attr_reader :post_payment_amount
+    # The amount of the credit note by which the invoice's `amount_remaining` and `amount_due` were reduced.
+    attr_reader :pre_payment_amount
     # The pretax credit amounts (ex: discount, credit grants, etc) for all line items.
     attr_reader :pretax_credit_amounts
     # Reason for issuing this credit note, one of `duplicate`, `fraudulent`, `order_change`, or `product_unsatisfactory`
@@ -654,20 +658,19 @@ module Stripe
     # The time that the credit note was voided.
     attr_reader :voided_at
 
-    # 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 self.create(params = {}, opts = {})
       request_stripe_object(method: :post, path: "/v1/credit_notes", params: params, opts: opts)
     end
@@ -707,7 +710,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(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -717,7 +720,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 self.void_credit_note(id, params = {}, opts = {})
       request_stripe_object(
         method: :post,

data/lib/stripe/resources/customer.rb

@@ -105,8 +105,7 @@ module Stripe
       attr_reader :location
     end
 
-    class DeleteParams < Stripe::RequestParams
-    end
+    class DeleteParams < Stripe::RequestParams; end
 
     class UpdateParams < Stripe::RequestParams
       class Address < Stripe::RequestParams
@@ -346,8 +345,7 @@ module Stripe
       end
     end
 
-    class DeleteDiscountParams < Stripe::RequestParams
-    end
+    class DeleteDiscountParams < Stripe::RequestParams; end
 
     class ListParams < Stripe::RequestParams
       class Created < Stripe::RequestParams
@@ -555,7 +553,7 @@ module Stripe
       end
 
       class TaxIdDatum < Stripe::RequestParams
-        # Type of the tax ID, one of `ad_nrt`, `ae_trn`, `al_tin`, `am_tin`, `ao_tin`, `ar_cuit`, `au_abn`, `au_arn`, `ba_tin`, `bb_tin`, `bg_uic`, `bh_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `bs_tin`, `by_tin`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `cd_nif`, `ch_uid`, `ch_vat`, `cl_tin`, `cn_tin`, `co_nit`, `cr_tin`, `de_stn`, `do_rcn`, `ec_ruc`, `eg_tin`, `es_cif`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `gn_nif`, `hk_br`, `hr_oib`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `ke_pin`, `kh_tin`, `kr_brn`, `kz_bin`, `li_uid`, `li_vat`, `ma_vat`, `md_vat`, `me_pib`, `mk_vat`, `mr_nif`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `ng_tin`, `no_vat`, `no_voec`, `np_pan`, `nz_gst`, `om_vat`, `pe_ruc`, `ph_tin`, `ro_tin`, `rs_pib`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `sn_ninea`, `sr_fin`, `sv_nit`, `th_vat`, `tj_tin`, `tr_tin`, `tw_vat`, `tz_vat`, `ua_vat`, `ug_tin`, `us_ein`, `uy_ruc`, `uz_tin`, `uz_vat`, `ve_rif`, `vn_tin`, `za_vat`, `zm_tin`, or `zw_tin`
+        # Type of the tax ID, one of `ad_nrt`, `ae_trn`, `al_tin`, `am_tin`, `ao_tin`, `ar_cuit`, `au_abn`, `au_arn`, `aw_tin`, `az_tin`, `ba_tin`, `bb_tin`, `bd_bin`, `bf_ifu`, `bg_uic`, `bh_vat`, `bj_ifu`, `bo_tin`, `br_cnpj`, `br_cpf`, `bs_tin`, `by_tin`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `cd_nif`, `ch_uid`, `ch_vat`, `cl_tin`, `cm_niu`, `cn_tin`, `co_nit`, `cr_tin`, `cv_nif`, `de_stn`, `do_rcn`, `ec_ruc`, `eg_tin`, `es_cif`, `et_tin`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `gn_nif`, `hk_br`, `hr_oib`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `ke_pin`, `kg_tin`, `kh_tin`, `kr_brn`, `kz_bin`, `la_tin`, `li_uid`, `li_vat`, `ma_vat`, `md_vat`, `me_pib`, `mk_vat`, `mr_nif`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `ng_tin`, `no_vat`, `no_voec`, `np_pan`, `nz_gst`, `om_vat`, `pe_ruc`, `ph_tin`, `ro_tin`, `rs_pib`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `sn_ninea`, `sr_fin`, `sv_nit`, `th_vat`, `tj_tin`, `tr_tin`, `tw_vat`, `tz_vat`, `ua_vat`, `ug_tin`, `us_ein`, `uy_ruc`, `uz_tin`, `uz_vat`, `ve_rif`, `vn_tin`, `za_vat`, `zm_tin`, or `zw_tin`
         attr_accessor :type
         # Value of the tax ID.
         attr_accessor :value
@@ -656,7 +654,7 @@ module Stripe
     end
 
     class ListPaymentMethodsParams < Stripe::RequestParams
-      # This field indicates whether this payment method can be shown again to its customer in a checkout flow. Stripe products such as Checkout and Elements use this field to determine whether a payment method can be shown as a saved payment method in a checkout flow. The field defaults to `unspecified`.
+      # This field indicates whether this payment method can be shown again to its customer in a checkout flow. Stripe products such as Checkout and Elements use this field to determine whether a payment method can be shown as a saved payment method in a checkout flow.
       attr_accessor :allow_redisplay
       # 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