stripe 17.0.1 → 19.0.0

data/lib/stripe/resources/v2/core/event.rb

@@ -11,8 +11,8 @@ module Stripe
           "v2.core.event"
         end
 
-        class Reason < Stripe::StripeObject
-          class Request < Stripe::StripeObject
+        class Reason < ::Stripe::StripeObject
+          class Request < ::Stripe::StripeObject
             # ID of the API request that caused the event.
             attr_reader :id
             # The idempotency key transmitted during the request.
@@ -39,20 +39,22 @@ module Stripe
             @field_remappings = {}
           end
         end
+        # Before and after changes for the primary related object.
+        attr_reader :changes
         # Authentication context needed to fetch the event or related object.
         attr_reader :context
         # Time at which the object was created.
         attr_reader :created
         # Unique identifier for the event.
         attr_reader :id
+        # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+        attr_reader :livemode
         # String representing the object's type. Objects of the same type share the same value of the object field.
         attr_reader :object
         # Reason for the event.
         attr_reader :reason
         # The type of the event.
         attr_reader :type
-        # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
-        attr_reader :livemode
 
         def self.inner_class_types
           @inner_class_types = { reason: Reason }

data/lib/stripe/resources/v2/core/event_destination.rb

@@ -11,8 +11,8 @@ module Stripe
           "v2.core.event_destination"
         end
 
-        class StatusDetails < Stripe::StripeObject
-          class Disabled < Stripe::StripeObject
+        class StatusDetails < ::Stripe::StripeObject
+          class Disabled < ::Stripe::StripeObject
             # Reason event destination has been disabled.
             attr_reader :reason
 
@@ -36,7 +36,7 @@ module Stripe
           end
         end
 
-        class AmazonEventbridge < Stripe::StripeObject
+        class AmazonEventbridge < ::Stripe::StripeObject
           # The AWS account ID.
           attr_reader :aws_account_id
           # The ARN of the AWS event source.
@@ -53,7 +53,7 @@ module Stripe
           end
         end
 
-        class WebhookEndpoint < Stripe::StripeObject
+        class WebhookEndpoint < ::Stripe::StripeObject
           # The signing secret of the webhook endpoint, only includable on creation.
           attr_reader :signing_secret
           # The URL of the webhook endpoint, includable.
@@ -75,7 +75,11 @@ module Stripe
         attr_reader :enabled_events
         # Payload type of events being subscribed to.
         attr_reader :event_payload
-        # Where events should be routed from.
+        # Specifies which accounts' events route to this destination.
+        # `@self`: Receive events from the account that owns the event destination.
+        # `@accounts`: Receive events emitted from other accounts you manage which includes your v1 and v2 accounts.
+        # `@organization_members`: Receive events from accounts directly linked to the organization.
+        # `@organization_members/@accounts`: Receive events from all accounts connected to any platform accounts in the organization.
         attr_reader :events_from
         # Unique identifier for the object.
         attr_reader :id

data/lib/stripe/resources/v2/core/event_notification.rb

@@ -52,7 +52,8 @@ module Stripe
 
         # Retrieves the Event that generated this EventNotification.
         def fetch_event
-          resp = @client.raw_request(:get, "/v2/core/events/#{id}", opts: { stripe_context: context },
+          resp = @client.raw_request(:get, "/v2/core/events/#{id}", opts: { stripe_context: context,
+                                                                            "Stripe-Request-Trigger" => "event=#{id}", },
                                                                     usage: ["fetch_event"])
           @client.deserialize(resp.http_body, api_mode: :v2)
         end

data/lib/stripe/resources/webhook_endpoint.rb

@@ -32,9 +32,9 @@ module Stripe
     attr_reader :enabled_events
     # Unique identifier for the object.
     attr_reader :id
-    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
     attr_reader :livemode
-    # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+    # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
     attr_reader :metadata
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object

data/lib/stripe/resources.rb

@@ -77,11 +77,14 @@ require "stripe/resources/issuing/transaction"
 require "stripe/resources/line_item"
 require "stripe/resources/login_link"
 require "stripe/resources/mandate"
+require "stripe/resources/payment_attempt_record"
 require "stripe/resources/payment_intent"
+require "stripe/resources/payment_intent_amount_details_line_item"
 require "stripe/resources/payment_link"
 require "stripe/resources/payment_method"
 require "stripe/resources/payment_method_configuration"
 require "stripe/resources/payment_method_domain"
+require "stripe/resources/payment_record"
 require "stripe/resources/payout"
 require "stripe/resources/person"
 require "stripe/resources/plan"
@@ -91,11 +94,15 @@ require "stripe/resources/product_feature"
 require "stripe/resources/promotion_code"
 require "stripe/resources/quote"
 require "stripe/resources/radar/early_fraud_warning"
+require "stripe/resources/radar/payment_evaluation"
 require "stripe/resources/radar/value_list"
 require "stripe/resources/radar/value_list_item"
 require "stripe/resources/refund"
 require "stripe/resources/reporting/report_run"
 require "stripe/resources/reporting/report_type"
+require "stripe/resources/reserve/hold"
+require "stripe/resources/reserve/plan"
+require "stripe/resources/reserve/release"
 require "stripe/resources/reserve_transaction"
 require "stripe/resources/reversal"
 require "stripe/resources/review"
@@ -109,6 +116,7 @@ require "stripe/resources/source_transaction"
 require "stripe/resources/subscription"
 require "stripe/resources/subscription_item"
 require "stripe/resources/subscription_schedule"
+require "stripe/resources/tax/association"
 require "stripe/resources/tax/calculation"
 require "stripe/resources/tax/calculation_line_item"
 require "stripe/resources/tax/registration"
@@ -122,6 +130,7 @@ require "stripe/resources/tax_rate"
 require "stripe/resources/terminal/configuration"
 require "stripe/resources/terminal/connection_token"
 require "stripe/resources/terminal/location"
+require "stripe/resources/terminal/onboarding_link"
 require "stripe/resources/terminal/reader"
 require "stripe/resources/test_helpers/test_clock"
 require "stripe/resources/token"
@@ -141,10 +150,32 @@ require "stripe/resources/treasury/transaction_entry"
 require "stripe/resources/v2/billing/meter_event"
 require "stripe/resources/v2/billing/meter_event_adjustment"
 require "stripe/resources/v2/billing/meter_event_session"
+require "stripe/resources/v2/core/account"
+require "stripe/resources/v2/core/account_link"
+require "stripe/resources/v2/core/account_person"
+require "stripe/resources/v2/core/account_person_token"
+require "stripe/resources/v2/core/account_token"
 require "stripe/resources/v2/core/event"
 require "stripe/resources/v2/core/event_destination"
 require "stripe/resources/v2/deleted_object"
 require "stripe/resources/webhook_endpoint"
 require "stripe/events/v1_billing_meter_error_report_triggered_event"
 require "stripe/events/v1_billing_meter_no_meter_found_event"
+require "stripe/events/v2_core_account_closed_event"
+require "stripe/events/v2_core_account_created_event"
+require "stripe/events/v2_core_account_including_configuration_customer_capability_status_updated_event"
+require "stripe/events/v2_core_account_including_configuration_customer_updated_event"
+require "stripe/events/v2_core_account_including_configuration_merchant_capability_status_updated_event"
+require "stripe/events/v2_core_account_including_configuration_merchant_updated_event"
+require "stripe/events/v2_core_account_including_configuration_recipient_capability_status_updated_event"
+require "stripe/events/v2_core_account_including_configuration_recipient_updated_event"
+require "stripe/events/v2_core_account_including_defaults_updated_event"
+require "stripe/events/v2_core_account_including_future_requirements_updated_event"
+require "stripe/events/v2_core_account_including_identity_updated_event"
+require "stripe/events/v2_core_account_including_requirements_updated_event"
+require "stripe/events/v2_core_account_link_returned_event"
+require "stripe/events/v2_core_account_person_created_event"
+require "stripe/events/v2_core_account_person_deleted_event"
+require "stripe/events/v2_core_account_person_updated_event"
+require "stripe/events/v2_core_account_updated_event"
 require "stripe/events/v2_core_event_destination_ping_event"

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

@@ -13,6 +13,8 @@ module Stripe
 
       # Creates a Checkout Session object.
       def create(params = {}, opts = {})
+        params = Checkout::SessionCreateParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
         request(
           method: :post,
           path: "/v1/checkout/sessions",
@@ -59,8 +61,10 @@ module Stripe
 
       # Updates a Checkout Session object.
       #
-      # Related guide: [Dynamically update Checkout](https://docs.stripe.com/payments/checkout/dynamic-updates)
+      # Related guide: [Dynamically update a Checkout Session](https://docs.stripe.com/payments/advanced/dynamic-updates)
       def update(session, params = {}, opts = {})
+        params = Checkout::SessionUpdateParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
         request(
           method: :post,
           path: format("/v1/checkout/sessions/%<session>s", { session: CGI.escape(session) }),

data/lib/stripe/services/climate/order_service.rb

@@ -21,6 +21,8 @@ module Stripe
       # Creates a Climate order object for a given Climate product. The order will be processed immediately
       # after creation and payment will be deducted your Stripe balance.
       def create(params = {}, opts = {})
+        params = Climate::OrderCreateParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
         request(
           method: :post,
           path: "/v1/climate/orders",

data/lib/stripe/services/credit_note_preview_lines_service.rb

@@ -5,6 +5,8 @@ module Stripe
   class CreditNotePreviewLinesService < StripeService
     # When retrieving a credit note preview, you'll get a lines property containing the first handful of those items. This URL you can retrieve the full (paginated) list of line items.
     def list(params = {}, opts = {})
+      params = CreditNotePreviewLinesListParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
       request(
         method: :get,
         path: "/v1/credit_notes/preview/lines",

data/lib/stripe/services/credit_note_service.rb

@@ -25,6 +25,8 @@ module Stripe
     # 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 = {})
+      params = CreditNoteCreateParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
       request(
         method: :post,
         path: "/v1/credit_notes",
@@ -47,6 +49,8 @@ module Stripe
 
     # Get a preview of a credit note without creating it.
     def preview(params = {}, opts = {})
+      params = CreditNotePreviewParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
       request(
         method: :get,
         path: "/v1/credit_notes/preview",

data/lib/stripe/services/customer_payment_source_service.rb

@@ -7,7 +7,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://docs.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/api/customers/update) to have a new default_source.
     def create(customer, params = {}, opts = {})
       request(
         method: :post,

data/lib/stripe/services/customer_service.rb

@@ -73,7 +73,7 @@ module Stripe
       )
     end
 
-    # Updates the specified customer by setting the values of the parameters passed. Any parameters not provided will be left unchanged. For example, if you pass the source parameter, that becomes the customer's active source (e.g., a card) to be used for all charges in the future. When you update a customer to a new valid card source by passing the source parameter: for each of the customer's current subscriptions, if the subscription bills automatically and is in the past_due state, then the latest open invoice for the subscription with automatic collection enabled will be retried. This retry will not count as an automatic retry, and will not affect the next regularly scheduled payment for the invoice. Changing the default_source for a customer will not trigger this behavior.
+    # Updates the specified customer by setting the values of the parameters passed. Any parameters not provided are left unchanged. For example, if you pass the source parameter, that becomes the customer's active source (such as a card) to be used for all charges in the future. When you update a customer to a new valid card source by passing the source parameter: for each of the customer's current subscriptions, if the subscription bills automatically and is in the past_due state, then the latest open invoice for the subscription with automatic collection enabled is retried. This retry doesn't count as an automatic retry, and doesn't affect the next regularly scheduled payment for the invoice. Changing the default_source for a customer doesn't trigger this behavior.
     #
     # This request accepts mostly the same arguments as the customer creation call.
     def update(customer, params = {}, opts = {})

data/lib/stripe/services/financial_connections/account_service.rb

@@ -55,7 +55,7 @@ module Stripe
         )
       end
 
-      # Subscribes to periodic refreshes of data associated with a Financial Connections Account.
+      # Subscribes to periodic refreshes of data associated with a Financial Connections Account. When the account status is active, data is typically refreshed once a day.
       def subscribe(account, params = {}, opts = {})
         request(
           method: :post,

data/lib/stripe/services/invoice_item_service.rb

@@ -5,6 +5,8 @@ module Stripe
   class InvoiceItemService < StripeService
     # Creates an item to be added to a draft invoice (up to 250 items per invoice). If no invoice is specified, the item will be on the next invoice created for the customer specified.
     def create(params = {}, opts = {})
+      params = InvoiceItemCreateParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
       request(
         method: :post,
         path: "/v1/invoiceitems",
@@ -49,6 +51,8 @@ module Stripe
 
     # Updates the amount or description of an invoice item on an upcoming invoice. Updating an invoice item is only possible before the invoice it's attached to is closed.
     def update(invoiceitem, params = {}, opts = {})
+      params = InvoiceItemUpdateParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
       request(
         method: :post,
         path: format("/v1/invoiceitems/%<invoiceitem>s", { invoiceitem: CGI.escape(invoiceitem) }),

data/lib/stripe/services/invoice_line_item_service.rb

@@ -19,6 +19,8 @@ module Stripe
     # item and the invoice line item, so updates on this endpoint will propagate to the invoice item as well.
     # Updating an invoice's line item is only possible before the invoice is finalized.
     def update(invoice, line_item_id, params = {}, opts = {})
+      params = InvoiceLineItemUpdateParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
       request(
         method: :post,
         path: format("/v1/invoices/%<invoice>s/lines/%<line_item_id>s", { invoice: CGI.escape(invoice), line_item_id: CGI.escape(line_item_id) }),

data/lib/stripe/services/invoice_service.rb

@@ -12,6 +12,8 @@ module Stripe
 
     # Adds multiple line items to an invoice. This is only possible when an invoice is still a draft.
     def add_lines(invoice, params = {}, opts = {})
+      params = InvoiceAddLinesParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
       request(
         method: :post,
         path: format("/v1/invoices/%<invoice>s/add_lines", { invoice: CGI.escape(invoice) }),
@@ -41,7 +43,7 @@ module Stripe
       )
     end
 
-    # This endpoint creates a draft invoice for a given customer. The invoice remains a draft until you [finalize the invoice, which allows you to [pay](#pay_invoice) or <a href="#send_invoice">send](https://docs.stripe.com/api#finalize_invoice) the invoice to your customers.
+    # This endpoint creates a draft invoice for a given customer. The invoice remains a draft until you [finalize the invoice, which allows you to [pay](/api/invoices/pay) or <a href="/api/invoices/send">send](https://docs.stripe.com/api/invoices/finalize) the invoice to your customers.
     def create(params = {}, opts = {})
       request(method: :post, path: "/v1/invoices", params: params, opts: opts, base_address: :api)
     end
@@ -56,6 +58,8 @@ module Stripe
     #
     # Note: Currency conversion calculations use the latest exchange rates. Exchange rates may vary between the time of the preview and the time of the actual invoice creation. [Learn more](https://docs.stripe.com/currencies/conversions)
     def create_preview(params = {}, opts = {})
+      params = InvoiceCreatePreviewParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
       request(
         method: :post,
         path: "/v1/invoices/create_preview",
@@ -65,7 +69,7 @@ module Stripe
       )
     end
 
-    # Permanently deletes a one-off invoice draft. This cannot be undone. Attempts to delete invoices that are no longer in a draft state will fail; once an invoice has been finalized or if an invoice is for a subscription, it must be [voided](https://docs.stripe.com/api#void_invoice).
+    # Permanently deletes a one-off invoice draft. This cannot be undone. Attempts to delete invoices that are no longer in a draft state will fail; once an invoice has been finalized or if an invoice is for a subscription, it must be [voided](https://docs.stripe.com/api/invoices/void).
     def delete(invoice, params = {}, opts = {})
       request(
         method: :delete,
@@ -181,6 +185,8 @@ module Stripe
 
     # Updates multiple line items on an invoice. This is only possible when an invoice is still a draft.
     def update_lines(invoice, params = {}, opts = {})
+      params = InvoiceUpdateLinesParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
       request(
         method: :post,
         path: format("/v1/invoices/%<invoice>s/update_lines", { invoice: CGI.escape(invoice) }),
@@ -190,9 +196,9 @@ module Stripe
       )
     end
 
-    # Mark a finalized invoice as void. This cannot be undone. Voiding an invoice is similar to [deletion](https://docs.stripe.com/api#delete_invoice), however it only applies to finalized invoices and maintains a papertrail where the invoice can still be found.
+    # Mark a finalized invoice as void. This cannot be undone. Voiding an invoice is similar to [deletion](https://docs.stripe.com/api/invoices/delete), however it only applies to finalized invoices and maintains a papertrail where the invoice can still be found.
     #
-    # Consult with local regulations to determine whether and how an invoice might be amended, canceled, or voided in the jurisdiction you're doing business in. You might need to [issue another invoice or <a href="#create_credit_note">credit note](https://docs.stripe.com/api#create_invoice) instead. Stripe recommends that you consult with your legal counsel for advice specific to your business.
+    # Consult with local regulations to determine whether and how an invoice might be amended, canceled, or voided in the jurisdiction you're doing business in. You might need to [issue another invoice or <a href="/api/credit_notes/create">credit note](https://docs.stripe.com/api/invoices/create) instead. Stripe recommends that you consult with your legal counsel for advice specific to your business.
     def void_invoice(invoice, params = {}, opts = {})
       request(
         method: :post,

data/lib/stripe/services/payment_attempt_record_service.rb

@@ -0,0 +1,28 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class PaymentAttemptRecordService < StripeService
+    # List all the Payment Attempt Records attached to the specified Payment Record.
+    def list(params = {}, opts = {})
+      request(
+        method: :get,
+        path: "/v1/payment_attempt_records",
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Retrieves a Payment Attempt Record with the given ID
+    def retrieve(id, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/payment_attempt_records/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end

data/lib/stripe/services/payment_intent_amount_details_line_item_service.rb

@@ -0,0 +1,17 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class PaymentIntentAmountDetailsLineItemService < StripeService
+    # Lists all LineItems of a given PaymentIntent.
+    def list(intent, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/payment_intents/%<intent>s/amount_details_line_items", { intent: CGI.escape(intent) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end

data/lib/stripe/services/payment_intent_service.rb

@@ -3,6 +3,13 @@
 
 module Stripe
   class PaymentIntentService < StripeService
+    attr_reader :amount_details_line_items
+
+    def initialize(requestor)
+      super
+      @amount_details_line_items = Stripe::PaymentIntentAmountDetailsLineItemService.new(@requestor)
+    end
+
     # Manually reconcile the remaining amount for a customer_balance PaymentIntent.
     def apply_customer_balance(intent, params = {}, opts = {})
       request(
@@ -18,7 +25,7 @@ module Stripe
     #
     # After it's canceled, no additional charges are made by the PaymentIntent and any operations on the PaymentIntent fail with an error. For PaymentIntents with a status of requires_capture, the remaining amount_capturable is automatically refunded.
     #
-    # You can't cancel the PaymentIntent for a Checkout Session. [Expire the Checkout Session](https://docs.stripe.com/docs/api/checkout/sessions/expire) instead.
+    # You can directly cancel the PaymentIntent for a Checkout Session only when the PaymentIntent has a status of requires_capture. Otherwise, you must [expire the Checkout Session](https://docs.stripe.com/docs/api/checkout/sessions/expire).
     def cancel(intent, params = {}, opts = {})
       request(
         method: :post,

data/lib/stripe/services/payment_link_service.rb

@@ -12,6 +12,8 @@ module Stripe
 
     # Creates a payment link.
     def create(params = {}, opts = {})
+      params = PaymentLinkCreateParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
       request(
         method: :post,
         path: "/v1/payment_links",

data/lib/stripe/services/payment_method_service.rb

@@ -50,7 +50,7 @@ module Stripe
       )
     end
 
-    # Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods attached to a Customer for payments, you should use the [List a Customer's PaymentMethods](https://docs.stripe.com/docs/api/payment_methods/customer_list) API instead.
+    # Returns a list of all PaymentMethods.
     def list(params = {}, opts = {})
       request(
         method: :get,

data/lib/stripe/services/payment_record_service.rb

@@ -0,0 +1,101 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  class PaymentRecordService < StripeService
+    # Report a new Payment Record. You may report a Payment Record as it is
+    #  initialized and later report updates through the other report_* methods, or report Payment
+    #  Records in a terminal state directly, through this method.
+    def report_payment(params = {}, opts = {})
+      request(
+        method: :post,
+        path: "/v1/payment_records/report_payment",
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Report a new payment attempt on the specified Payment Record. A new payment
+    #  attempt can only be specified if all other payment attempts are canceled or failed.
+    def report_payment_attempt(id, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/payment_records/%<id>s/report_payment_attempt", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Report that the most recent payment attempt on the specified Payment Record
+    #  was canceled.
+    def report_payment_attempt_canceled(id, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/payment_records/%<id>s/report_payment_attempt_canceled", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Report that the most recent payment attempt on the specified Payment Record
+    #  failed or errored.
+    def report_payment_attempt_failed(id, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/payment_records/%<id>s/report_payment_attempt_failed", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Report that the most recent payment attempt on the specified Payment Record
+    #  was guaranteed.
+    def report_payment_attempt_guaranteed(id, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/payment_records/%<id>s/report_payment_attempt_guaranteed", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Report informational updates on the specified Payment Record.
+    def report_payment_attempt_informational(id, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/payment_records/%<id>s/report_payment_attempt_informational", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Report that the most recent payment attempt on the specified Payment Record
+    #  was refunded.
+    def report_refund(id, params = {}, opts = {})
+      request(
+        method: :post,
+        path: format("/v1/payment_records/%<id>s/report_refund", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+
+    # Retrieves a Payment Record with the given ID
+    def retrieve(id, params = {}, opts = {})
+      request(
+        method: :get,
+        path: format("/v1/payment_records/%<id>s", { id: CGI.escape(id) }),
+        params: params,
+        opts: opts,
+        base_address: :api
+      )
+    end
+  end
+end

data/lib/stripe/services/payout_service.rb

@@ -18,7 +18,7 @@ module Stripe
     #
     # If your API key is in test mode, money won't actually be sent, though every other action occurs as if you're in live mode.
     #
-    # If you create a manual payout on a Stripe account that uses multiple payment source types, you need to specify the source type balance that the payout draws from. The [balance object](https://docs.stripe.com/api#balance_object) details available and pending amounts by source type.
+    # If you create a manual payout on a Stripe account that uses multiple payment source types, you need to specify the source type balance that the payout draws from. The [balance object](https://docs.stripe.com/api/balances/object) details available and pending amounts by source type.
     def create(params = {}, opts = {})
       request(method: :post, path: "/v1/payouts", params: params, opts: opts, base_address: :api)
     end
@@ -39,7 +39,7 @@ module Stripe
       )
     end
 
-    # Reverses a payout by debiting the destination bank account. At this time, you can only reverse payouts for connected accounts to US bank accounts. If the payout is manual and in the pending status, use /v1/payouts/:id/cancel instead.
+    # Reverses a payout by debiting the destination bank account. At this time, you can only reverse payouts for connected accounts to US and Canadian bank accounts. If the payout is manual and in the pending status, use /v1/payouts/:id/cancel instead.
     #
     # By requesting a reversal through /v1/payouts/:id/reverse, you confirm that the authorized signatory of the selected bank account authorizes the debit on the bank account and that no other authorization is required.
     def reverse(payout, params = {}, opts = {})

data/lib/stripe/services/plan_service.rb

@@ -5,6 +5,8 @@ module Stripe
   class PlanService < StripeService
     # You can now model subscriptions more flexibly using the [Prices API](https://docs.stripe.com/api#prices). It replaces the Plans API and is backwards compatible to simplify your migration.
     def create(params = {}, opts = {})
+      params = PlanCreateParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
       request(method: :post, path: "/v1/plans", params: params, opts: opts, base_address: :api)
     end
 

data/lib/stripe/services/price_service.rb

@@ -5,6 +5,8 @@ module Stripe
   class PriceService < StripeService
     # Creates a new [Price for an existing <a href="https://docs.stripe.com/api/products">Product](https://docs.stripe.com/api/prices). The Price can be recurring or one-time.
     def create(params = {}, opts = {})
+      params = PriceCreateParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
       request(method: :post, path: "/v1/prices", params: params, opts: opts, base_address: :api)
     end
 

data/lib/stripe/services/product_service.rb

@@ -12,6 +12,8 @@ module Stripe
 
     # Creates a new product object.
     def create(params = {}, opts = {})
+      params = ProductCreateParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
       request(method: :post, path: "/v1/products", params: params, opts: opts, base_address: :api)
     end
 

data/lib/stripe/services/quote_service.rb

@@ -35,6 +35,8 @@ module Stripe
 
     # A quote models prices and services for a customer. Default options for header, description, footer, and expires_at can be set in the dashboard via the [quote template](https://dashboard.stripe.com/settings/billing/quote).
     def create(params = {}, opts = {})
+      params = QuoteCreateParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
       request(method: :post, path: "/v1/quotes", params: params, opts: opts, base_address: :api)
     end
 
@@ -80,6 +82,8 @@ module Stripe
 
     # A quote models prices and services for a customer.
     def update(quote, params = {}, opts = {})
+      params = QuoteUpdateParams.coerce_params(params) unless params.is_a?(Stripe::RequestParams)
+
       request(
         method: :post,
         path: format("/v1/quotes/%<quote>s", { quote: CGI.escape(quote) }),

data/lib/stripe/services/radar/payment_evaluation_service.rb

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Radar
+    class PaymentEvaluationService < StripeService
+      # Request a Radar API fraud risk score from Stripe for a payment before sending it for external processor authorization.
+      def create(params = {}, opts = {})
+        request(
+          method: :post,
+          path: "/v1/radar/payment_evaluations",
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+    end
+  end
+end