stripe 15.1.0 → 15.2.0

data/lib/stripe/services/account_session_service.rb

@@ -95,8 +95,28 @@ module Stripe
           end
         end
 
-        class Documents < Stripe::RequestParams
+        class DisputesList < Stripe::RequestParams
           class Features < Stripe::RequestParams
+            # Whether to allow capturing and cancelling payment intents. This is `true` by default.
+            attr_accessor :capture_payments
+            # Whether to allow connected accounts to manage destination charges that are created on behalf of them. This is `false` by default.
+            attr_accessor :destination_on_behalf_of_charge_management
+            # Whether to allow responding to disputes, including submitting evidence and accepting disputes. This is `true` by default.
+            attr_accessor :dispute_management
+            # Whether to allow sending refunds. This is `true` by default.
+            attr_accessor :refund_management
+
+            def initialize(
+              capture_payments: nil,
+              destination_on_behalf_of_charge_management: nil,
+              dispute_management: nil,
+              refund_management: nil
+            )
+              @capture_payments = capture_payments
+              @destination_on_behalf_of_charge_management = destination_on_behalf_of_charge_management
+              @dispute_management = dispute_management
+              @refund_management = refund_management
+            end
           end
           # Whether the embedded component is enabled.
           attr_accessor :enabled
@@ -109,6 +129,19 @@ module Stripe
           end
         end
 
+        class Documents < Stripe::RequestParams
+          class Features < Stripe::RequestParams; end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # The list of features enabled in the embedded component.
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
+
         class FinancialAccount < Stripe::RequestParams
           class Features < Stripe::RequestParams
             # Disables Stripe user authentication for this embedded component. This value can only be true for accounts where `controller.requirement_collection` is `application`. The default value is the opposite of the `external_account_collection` value. For example, if you don’t set `external_account_collection`, it defaults to true and `disable_stripe_user_authentication` defaults to false.
@@ -295,6 +328,36 @@ module Stripe
           end
         end
 
+        class PaymentDisputes < Stripe::RequestParams
+          class Features < Stripe::RequestParams
+            # Whether to allow connected accounts to manage destination charges that are created on behalf of them. This is `false` by default.
+            attr_accessor :destination_on_behalf_of_charge_management
+            # Whether to allow responding to disputes, including submitting evidence and accepting disputes. This is `true` by default.
+            attr_accessor :dispute_management
+            # Whether to allow sending refunds. This is `true` by default.
+            attr_accessor :refund_management
+
+            def initialize(
+              destination_on_behalf_of_charge_management: nil,
+              dispute_management: nil,
+              refund_management: nil
+            )
+              @destination_on_behalf_of_charge_management = destination_on_behalf_of_charge_management
+              @dispute_management = dispute_management
+              @refund_management = refund_management
+            end
+          end
+          # Whether the embedded component is enabled.
+          attr_accessor :enabled
+          # The list of features enabled in the embedded component.
+          attr_accessor :features
+
+          def initialize(enabled: nil, features: nil)
+            @enabled = enabled
+            @features = features
+          end
+        end
+
         class Payments < Stripe::RequestParams
           class Features < Stripe::RequestParams
             # Whether to allow capturing and cancelling payment intents. This is `true` by default.
@@ -368,8 +431,7 @@ module Stripe
         end
 
         class PayoutsList < Stripe::RequestParams
-          class Features < Stripe::RequestParams
-          end
+          class Features < Stripe::RequestParams; end
           # Whether the embedded component is enabled.
           attr_accessor :enabled
           # The list of features enabled in the embedded component.
@@ -382,8 +444,7 @@ module Stripe
         end
 
         class TaxRegistrations < Stripe::RequestParams
-          class Features < Stripe::RequestParams
-          end
+          class Features < Stripe::RequestParams; end
           # Whether the embedded component is enabled.
           attr_accessor :enabled
           # The list of features enabled in the embedded component.
@@ -396,8 +457,7 @@ module Stripe
         end
 
         class TaxSettings < Stripe::RequestParams
-          class Features < Stripe::RequestParams
-          end
+          class Features < Stripe::RequestParams; end
           # Whether the embedded component is enabled.
           attr_accessor :enabled
           # The list of features enabled in the embedded component.
@@ -414,6 +474,8 @@ module Stripe
         attr_accessor :account_onboarding
         # Configuration for the balances embedded component.
         attr_accessor :balances
+        # Configuration for the disputes list embedded component.
+        attr_accessor :disputes_list
         # Configuration for the documents embedded component.
         attr_accessor :documents
         # Configuration for the financial account embedded component.
@@ -428,6 +490,8 @@ module Stripe
         attr_accessor :notification_banner
         # Configuration for the payment details embedded component.
         attr_accessor :payment_details
+        # Configuration for the payment disputes embedded component.
+        attr_accessor :payment_disputes
         # Configuration for the payments embedded component.
         attr_accessor :payments
         # Configuration for the payouts embedded component.
@@ -443,6 +507,7 @@ module Stripe
           account_management: nil,
           account_onboarding: nil,
           balances: nil,
+          disputes_list: nil,
           documents: nil,
           financial_account: nil,
           financial_account_transactions: nil,
@@ -450,6 +515,7 @@ module Stripe
           issuing_cards_list: nil,
           notification_banner: nil,
           payment_details: nil,
+          payment_disputes: nil,
           payments: nil,
           payouts: nil,
           payouts_list: nil,
@@ -459,6 +525,7 @@ module Stripe
           @account_management = account_management
           @account_onboarding = account_onboarding
           @balances = balances
+          @disputes_list = disputes_list
           @documents = documents
           @financial_account = financial_account
           @financial_account_transactions = financial_account_transactions
@@ -466,6 +533,7 @@ module Stripe
           @issuing_cards_list = issuing_cards_list
           @notification_banner = notification_banner
           @payment_details = payment_details
+          @payment_disputes = payment_disputes
           @payments = payments
           @payouts = payouts
           @payouts_list = payouts_list

data/lib/stripe/services/apple_pay_domain_service.rb

@@ -3,8 +3,7 @@
 
 module Stripe
   class ApplePayDomainService < StripeService
-    class DeleteParams < Stripe::RequestParams
-    end
+    class DeleteParams < Stripe::RequestParams; end
 
     class RetrieveParams < Stripe::RequestParams
       # Specifies which fields in the response should be expanded.

data/lib/stripe/services/balance_service.rb

@@ -13,7 +13,7 @@ module Stripe
     end
 
     # Retrieves the current account balance, based on the authentication that was used to make the request.
-    #  For a sample request, see [Accounting for negative balances](https://stripe.com/docs/connect/account-balances#accounting-for-negative-balances).
+    #  For a sample request, see [Accounting for negative balances](https://docs.stripe.com/docs/connect/account-balances#accounting-for-negative-balances).
     def retrieve(params = {}, opts = {})
       request(method: :get, path: "/v1/balance", params: params, opts: opts, base_address: :api)
     end

data/lib/stripe/services/charge_service.rb

@@ -407,9 +407,9 @@ module Stripe
 
     # Capture the payment of an existing, uncaptured charge that was created with the capture option set to false.
     #
-    # Uncaptured payments expire a set number of days after they are created ([7 by default](https://stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
+    # Uncaptured payments expire a set number of days after they are created ([7 by default](https://docs.stripe.com/docs/charges/placing-a-hold)), after which they are marked as refunded and capture attempts will fail.
     #
-    # Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://stripe.com/docs/api/payment_intents/capture).
+    # Don't use this method to capture a PaymentIntent-initiated charge. Use [Capture a PaymentIntent](https://docs.stripe.com/docs/api/payment_intents/capture).
     def capture(charge, params = {}, opts = {})
       request(
         method: :post,
@@ -420,7 +420,7 @@ module Stripe
       )
     end
 
-    # This method is no longer recommended—use the [Payment Intents API](https://stripe.com/docs/api/payment_intents)
+    # This method is no longer recommended—use the [Payment Intents API](https://docs.stripe.com/docs/api/payment_intents)
     # to initiate a new payment instead. Confirmation of the PaymentIntent creates the Charge
     # object used to request payment.
     def create(params = {}, opts = {})
@@ -443,7 +443,7 @@ module Stripe
       )
     end
 
-    # Search for charges you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+    # Search for charges you've previously created using Stripe's [Search Query Language](https://docs.stripe.com/docs/search#search-query-language).
     # Don't use search in read-after-write flows where strict consistency is necessary. Under normal operating
     # conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up
     # to an hour behind during outages. Search functionality is not available to merchants in India.

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

@@ -1310,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.
@@ -1707,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
@@ -2473,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.

data/lib/stripe/services/credit_note_service.rb

@@ -376,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,
@@ -444,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,

data/lib/stripe/services/customer_service.rb

@@ -16,8 +16,7 @@ module Stripe
       @funding_instructions = Stripe::CustomerFundingInstructionsService.new(@requestor)
     end
 
-    class DeleteParams < Stripe::RequestParams
-    end
+    class DeleteParams < Stripe::RequestParams; end
 
     class RetrieveParams < Stripe::RequestParams
       # Specifies which fields in the response should be expanded.
@@ -266,8 +265,7 @@ module Stripe
       end
     end
 
-    class DeleteDiscountParams < Stripe::RequestParams
-    end
+    class DeleteDiscountParams < Stripe::RequestParams; end
 
     class ListParams < Stripe::RequestParams
       class Created < Stripe::RequestParams
@@ -636,7 +634,7 @@ module Stripe
       )
     end
 
-    # Search for customers you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+    # Search for customers you've previously created using Stripe's [Search Query Language](https://docs.stripe.com/docs/search#search-query-language).
     # Don't use search in read-after-write flows where strict consistency is necessary. Under normal operating
     # conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up
     # to an hour behind during outages. Search functionality is not available to merchants in India.

data/lib/stripe/services/customer_tax_id_service.rb

@@ -3,8 +3,7 @@
 
 module Stripe
   class CustomerTaxIdService < StripeService
-    class DeleteParams < Stripe::RequestParams
-    end
+    class DeleteParams < Stripe::RequestParams; end
 
     class RetrieveParams < Stripe::RequestParams
       # Specifies which fields in the response should be expanded.

data/lib/stripe/services/dispute_service.rb

@@ -408,7 +408,7 @@ module Stripe
 
     # When you get a dispute, contacting your customer is always the best first step. If that doesn't work, you can submit evidence to help us resolve the dispute in your favor. You can do this in your [dashboard](https://dashboard.stripe.com/disputes), but if you prefer, you can use the API to submit evidence programmatically.
     #
-    # Depending on your dispute type, different evidence fields will give you a better chance of winning your dispute. To figure out which evidence fields to provide, see our [guide to dispute types](https://stripe.com/docs/disputes/categories).
+    # Depending on your dispute type, different evidence fields will give you a better chance of winning your dispute. To figure out which evidence fields to provide, see our [guide to dispute types](https://docs.stripe.com/docs/disputes/categories).
     def update(dispute, params = {}, opts = {})
       request(
         method: :post,

data/lib/stripe/services/file_service.rb

@@ -110,7 +110,7 @@ module Stripe
       request(method: :get, path: "/v1/files", params: params, opts: opts, base_address: :api)
     end
 
-    # Retrieves the details of an existing file object. After you supply a unique file ID, Stripe returns the corresponding file object. Learn how to [access file contents](https://stripe.com/docs/file-upload#download-file-contents).
+    # Retrieves the details of an existing file object. After you supply a unique file ID, Stripe returns the corresponding file object. Learn how to [access file contents](https://docs.stripe.com/docs/file-upload#download-file-contents).
     def retrieve(file, params = {}, opts = {})
       request(
         method: :get,

data/lib/stripe/services/identity/verification_session_service.rb

@@ -235,9 +235,9 @@ module Stripe
         end
       end
 
-      # A VerificationSession object can be canceled when it is in requires_input [status](https://stripe.com/docs/identity/how-sessions-work).
+      # A VerificationSession object can be canceled when it is in requires_input [status](https://docs.stripe.com/docs/identity/how-sessions-work).
       #
-      # Once canceled, future submission attempts are disabled. This cannot be undone. [Learn more](https://stripe.com/docs/identity/verification-sessions#cancel).
+      # Once canceled, future submission attempts are disabled. This cannot be undone. [Learn more](https://docs.stripe.com/docs/identity/verification-sessions#cancel).
       def cancel(session, params = {}, opts = {})
         request(
           method: :post,
@@ -254,7 +254,7 @@ module Stripe
       #
       # If your API key is in test mode, verification checks won't actually process, though everything else will occur as if in live mode.
       #
-      # Related guide: [Verify your users' identity documents](https://stripe.com/docs/identity/verify-identity-documents)
+      # Related guide: [Verify your users' identity documents](https://docs.stripe.com/docs/identity/verify-identity-documents)
       def create(params = {}, opts = {})
         request(
           method: :post,
@@ -281,7 +281,7 @@ module Stripe
       # request logs, etc.
       #
       # A VerificationSession object can be redacted when it is in requires_input or verified
-      # [status](https://stripe.com/docs/identity/how-sessions-work). Redacting a VerificationSession in requires_action
+      # [status](https://docs.stripe.com/docs/identity/how-sessions-work). Redacting a VerificationSession in requires_action
       # state will automatically cancel it.
       #
       # The redaction process may take up to four days. When the redaction process is in progress, the
@@ -294,7 +294,7 @@ module Stripe
       # placeholder. The metadata field will also be erased. Redacted objects cannot be updated or
       # used for any purpose.
       #
-      # [Learn more](https://stripe.com/docs/identity/verification-sessions#redact).
+      # [Learn more](https://docs.stripe.com/docs/identity/verification-sessions#redact).
       def redact(session, params = {}, opts = {})
         request(
           method: :post,

data/lib/stripe/services/invoice_item_service.rb

@@ -3,8 +3,7 @@
 
 module Stripe
   class InvoiceItemService < StripeService
-    class DeleteParams < Stripe::RequestParams
-    end
+    class DeleteParams < Stripe::RequestParams; end
 
     class RetrieveParams < Stripe::RequestParams
       # Specifies which fields in the response should be expanded.