stripe 5.55.0 → 8.3.0

data/lib/stripe/resources/payment_method.rb

@@ -2,6 +2,11 @@
 # frozen_string_literal: true
 
 module Stripe
+  # PaymentMethod objects represent your customer's payment instruments.
+  # You can use them with [PaymentIntents](https://stripe.com/docs/payments/payment-intents) to collect payments or save them to
+  # Customer objects to store instrument details for future payments.
+  #
+  # Related guides: [Payment Methods](https://stripe.com/docs/payments/payment-methods) and [More Payment Scenarios](https://stripe.com/docs/payments/more-payment-scenarios).
   class PaymentMethod < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
@@ -9,13 +14,10 @@ module Stripe
 
     OBJECT_NAME = "payment_method"
 
-    custom_method :attach, http_verb: :post
-    custom_method :detach, http_verb: :post
-
     def attach(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: resource_url + "/attach",
+        path: format("/v1/payment_methods/%<payment_method>s/attach", { payment_method: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
@@ -24,7 +26,25 @@ module Stripe
     def detach(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: resource_url + "/detach",
+        path: format("/v1/payment_methods/%<payment_method>s/detach", { payment_method: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.attach(payment_method, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/payment_methods/%<payment_method>s/attach", { payment_method: CGI.escape(payment_method) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.detach(payment_method, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/payment_methods/%<payment_method>s/detach", { payment_method: CGI.escape(payment_method) }),
         params: params,
         opts: opts
       )

data/lib/stripe/resources/payout.rb

@@ -2,6 +2,14 @@
 # frozen_string_literal: true
 
 module Stripe
+  # A `Payout` object is created when you receive funds from Stripe, or when you
+  # initiate a payout to either a bank account or debit card of a [connected
+  # Stripe account](https://stripe.com/docs/connect/bank-debit-card-payouts). You can retrieve individual payouts,
+  # as well as list all payouts. Payouts are made on [varying
+  # schedules](https://stripe.com/docs/connect/manage-payout-schedule), depending on your country and
+  # industry.
+  #
+  # Related guide: [Receiving Payouts](https://stripe.com/docs/payouts).
   class Payout < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
@@ -9,13 +17,10 @@ module Stripe
 
     OBJECT_NAME = "payout"
 
-    custom_method :cancel, http_verb: :post
-    custom_method :reverse, http_verb: :post
-
     def cancel(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: resource_url + "/cancel",
+        path: format("/v1/payouts/%<payout>s/cancel", { payout: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
@@ -24,7 +29,25 @@ module Stripe
     def reverse(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: resource_url + "/reverse",
+        path: format("/v1/payouts/%<payout>s/reverse", { payout: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.cancel(payout, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/payouts/%<payout>s/cancel", { payout: CGI.escape(payout) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.reverse(payout, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/payouts/%<payout>s/reverse", { payout: CGI.escape(payout) }),
         params: params,
         opts: opts
       )

data/lib/stripe/resources/person.rb

@@ -2,6 +2,12 @@
 # frozen_string_literal: true
 
 module Stripe
+  # This is an object representing a person associated with a Stripe account.
+  #
+  # A platform cannot access a Standard or Express account's persons after the account starts onboarding, such as after generating an account link for the account.
+  # See the [Standard onboarding](https://stripe.com/docs/connect/standard-accounts) or [Express onboarding documentation](https://stripe.com/docs/connect/express-accounts) for information about platform pre-filling and account onboarding steps.
+  #
+  # Related guide: [Handling Identity Verification with the API](https://stripe.com/docs/connect/identity-verification-api#person-information).
   class Person < APIResource
     extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save

data/lib/stripe/resources/plan.rb

@@ -2,6 +2,14 @@
 # frozen_string_literal: true
 
 module Stripe
+  # You can now model subscriptions more flexibly using the [Prices API](https://stripe.com/docs/api#prices). It replaces the Plans API and is backwards compatible to simplify your migration.
+  #
+  # Plans define the base price, currency, and billing cycle for recurring purchases of products.
+  # [Products](https://stripe.com/docs/api#products) help you track inventory or provisioning, and plans help you track pricing. Different physical goods or levels of service should be represented by products, and pricing options should be represented by plans. This approach lets you change prices without having to change your provisioning scheme.
+  #
+  # For example, you might have a single "gold" product that has plans for $10/month, $100/year, €9/month, and €90/year.
+  #
+  # Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription) and more about [products and prices](https://stripe.com/docs/products-prices/overview).
   class Plan < APIResource
     extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Delete

data/lib/stripe/resources/price.rb

@@ -2,6 +2,12 @@
 # frozen_string_literal: true
 
 module Stripe
+  # Prices define the unit cost, currency, and (optional) billing cycle for both recurring and one-time purchases of products.
+  # [Products](https://stripe.com/docs/api#products) help you track inventory or provisioning, and prices help you track payment terms. Different physical goods or levels of service should be represented by products, and pricing options should be represented by prices. This approach lets you change prices without having to change your provisioning scheme.
+  #
+  # For example, you might have a single "gold" product that has prices for $10/month, $100/year, and €9 once.
+  #
+  # Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription), [create an invoice](https://stripe.com/docs/billing/invoices/create), and more about [products and prices](https://stripe.com/docs/products-prices/overview).
   class Price < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List

data/lib/stripe/resources/product.rb

@@ -2,6 +2,14 @@
 # frozen_string_literal: true
 
 module Stripe
+  # Products describe the specific goods or services you offer to your customers.
+  # For example, you might offer a Standard and Premium version of your goods or service; each version would be a separate Product.
+  # They can be used in conjunction with [Prices](https://stripe.com/docs/api#prices) to configure pricing in Payment Links, Checkout, and Subscriptions.
+  #
+  # Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription),
+  # [share a Payment Link](https://stripe.com/docs/payments/payment-links/overview),
+  # [accept payments with Checkout](https://stripe.com/docs/payments/accept-a-payment#create-product-prices-upfront),
+  # and more about [Products and Prices](https://stripe.com/docs/products-prices/overview)
   class Product < APIResource
     extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Delete

data/lib/stripe/resources/promotion_code.rb

@@ -2,6 +2,8 @@
 # frozen_string_literal: true
 
 module Stripe
+  # A Promotion Code represents a customer-redeemable code for a [coupon](https://stripe.com/docs/api#coupons). It can be used to
+  # create multiple codes for a single coupon.
   class PromotionCode < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List

data/lib/stripe/resources/quote.rb

@@ -2,6 +2,8 @@
 # frozen_string_literal: true
 
 module Stripe
+  # A Quote is a way to model prices that you'd like to provide to a customer.
+  # Once accepted, it will automatically create an invoice, subscription or subscription schedule.
   class Quote < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
@@ -9,16 +11,10 @@ module Stripe
 
     OBJECT_NAME = "quote"
 
-    custom_method :accept, http_verb: :post
-    custom_method :cancel, http_verb: :post
-    custom_method :finalize_quote, http_verb: :post, http_path: "finalize"
-    custom_method :list_computed_upfront_line_items, http_verb: :get, http_path: "computed_upfront_line_items"
-    custom_method :list_line_items, http_verb: :get, http_path: "line_items"
-
     def accept(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: resource_url + "/accept",
+        path: format("/v1/quotes/%<quote>s/accept", { quote: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
@@ -27,7 +23,7 @@ module Stripe
     def cancel(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: resource_url + "/cancel",
+        path: format("/v1/quotes/%<quote>s/cancel", { quote: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
@@ -36,7 +32,7 @@ module Stripe
     def finalize_quote(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: resource_url + "/finalize",
+        path: format("/v1/quotes/%<quote>s/finalize", { quote: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
@@ -45,7 +41,7 @@ module Stripe
     def list_computed_upfront_line_items(params = {}, opts = {})
       request_stripe_object(
         method: :get,
-        path: resource_url + "/computed_upfront_line_items",
+        path: format("/v1/quotes/%<quote>s/computed_upfront_line_items", { quote: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
@@ -54,7 +50,52 @@ module Stripe
     def list_line_items(params = {}, opts = {})
       request_stripe_object(
         method: :get,
-        path: resource_url + "/line_items",
+        path: format("/v1/quotes/%<quote>s/line_items", { quote: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.accept(quote, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/accept", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.cancel(quote, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/cancel", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.finalize_quote(quote, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/quotes/%<quote>s/finalize", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.list_computed_upfront_line_items(quote, params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/quotes/%<quote>s/computed_upfront_line_items", { quote: CGI.escape(quote) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.list_line_items(quote, params = {}, opts = {})
+      request_stripe_object(
+        method: :get,
+        path: format("/v1/quotes/%<quote>s/line_items", { quote: CGI.escape(quote) }),
         params: params,
         opts: opts
       )

data/lib/stripe/resources/radar/early_fraud_warning.rb

@@ -3,6 +3,10 @@
 
 module Stripe
   module Radar
+    # An early fraud warning indicates that the card issuer has notified us that a
+    # charge may be fraudulent.
+    #
+    # Related guide: [Early Fraud Warnings](https://stripe.com/docs/disputes/measuring#early-fraud-warnings).
     class EarlyFraudWarning < APIResource
       extend Stripe::APIOperations::List
 

data/lib/stripe/resources/radar/value_list.rb

@@ -3,6 +3,9 @@
 
 module Stripe
   module Radar
+    # Value lists allow you to group values together which can then be referenced in rules.
+    #
+    # Related guide: [Default Stripe Lists](https://stripe.com/docs/radar/lists#managing-list-items).
     class ValueList < APIResource
       extend Stripe::APIOperations::Create
       include Stripe::APIOperations::Delete

data/lib/stripe/resources/radar/value_list_item.rb

@@ -3,6 +3,9 @@
 
 module Stripe
   module Radar
+    # Value list items allow you to add specific values to a given Radar value list, which can then be used in rules.
+    #
+    # Related guide: [Managing List Items](https://stripe.com/docs/radar/lists#managing-list-items).
     class ValueListItem < APIResource
       extend Stripe::APIOperations::Create
       include Stripe::APIOperations::Delete

data/lib/stripe/resources/refund.rb

@@ -2,6 +2,11 @@
 # frozen_string_literal: true
 
 module Stripe
+  # `Refund` objects allow you to refund a charge that has previously been created
+  # but not yet refunded. Funds will be refunded to the credit or debit card that
+  # was originally charged.
+  #
+  # Related guide: [Refunds](https://stripe.com/docs/refunds).
   class Refund < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
@@ -9,12 +14,19 @@ module Stripe
 
     OBJECT_NAME = "refund"
 
-    custom_method :cancel, http_verb: :post
-
     def cancel(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: resource_url + "/cancel",
+        path: format("/v1/refunds/%<refund>s/cancel", { refund: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.cancel(refund, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/refunds/%<refund>s/cancel", { refund: CGI.escape(refund) }),
         params: params,
         opts: opts
       )
@@ -27,12 +39,19 @@ module Stripe
     class TestHelpers < APIResourceTestHelpers
       RESOURCE_CLASS = Refund
 
-      custom_method :expire, http_verb: :post
+      def self.expire(refund, params = {}, opts = {})
+        request_stripe_object(
+          method: :post,
+          path: format("/v1/test_helpers/refunds/%<refund>s/expire", { refund: CGI.escape(refund) }),
+          params: params,
+          opts: opts
+        )
+      end
 
       def expire(params = {}, opts = {})
         @resource.request_stripe_object(
           method: :post,
-          path: resource_url + "/expire",
+          path: format("/v1/test_helpers/refunds/%<refund>s/expire", { refund: CGI.escape(@resource["id"]) }),
           params: params,
           opts: opts
         )

data/lib/stripe/resources/reporting/report_run.rb

@@ -3,6 +3,14 @@
 
 module Stripe
   module Reporting
+    # The Report Run object represents an instance of a report type generated with
+    # specific run parameters. Once the object is created, Stripe begins processing the report.
+    # When the report has finished running, it will give you a reference to a file
+    # where you can retrieve your results. For an overview, see
+    # [API Access to Reports](https://stripe.com/docs/reporting/statements/api).
+    #
+    # Note that certain report types can only be run based on your live-mode data (not test-mode
+    # data), and will error when queried without a [live-mode API key](https://stripe.com/docs/keys#test-live-modes).
     class ReportRun < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List

data/lib/stripe/resources/reporting/report_type.rb

@@ -3,8 +3,15 @@
 
 module Stripe
   module Reporting
+    # The Report Type resource corresponds to a particular type of report, such as
+    # the "Activity summary" or "Itemized payouts" reports. These objects are
+    # identified by an ID belonging to a set of enumerated values. See
+    # [API Access to Reports documentation](https://stripe.com/docs/reporting/statements/api)
+    # for those Report Type IDs, along with required and optional parameters.
+    #
+    # Note that certain report types can only be run based on your live-mode data (not test-mode
+    # data), and will error when queried without a [live-mode API key](https://stripe.com/docs/keys#test-live-modes).
     class ReportType < APIResource
-      extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List
 
       OBJECT_NAME = "reporting.report_type"

data/lib/stripe/resources/reversal.rb

@@ -2,6 +2,19 @@
 # frozen_string_literal: true
 
 module Stripe
+  # [Stripe Connect](https://stripe.com/docs/connect) platforms can reverse transfers made to a
+  # connected account, either entirely or partially, and can also specify whether
+  # to refund any related application fees. Transfer reversals add to the
+  # platform's balance and subtract from the destination account's balance.
+  #
+  # Reversing a transfer that was made for a [destination
+  # charge](https://stripe.com/docs/connect/destination-charges) is allowed only up to the amount of
+  # the charge. It is possible to reverse a
+  # [transfer_group](https://stripe.com/docs/connect/charges-transfers#transfer-options)
+  # transfer only if the destination account has enough balance to cover the
+  # reversal.
+  #
+  # Related guide: [Reversing Transfers](https://stripe.com/docs/connect/charges-transfers#reversing-transfers).
   class Reversal < APIResource
     extend Stripe::APIOperations::List
     include Stripe::APIOperations::Save

data/lib/stripe/resources/review.rb

@@ -2,17 +2,28 @@
 # frozen_string_literal: true
 
 module Stripe
+  # Reviews can be used to supplement automated fraud detection with human expertise.
+  #
+  # Learn more about [Radar](https://stripe.com/radar) and reviewing payments
+  # [here](https://stripe.com/docs/radar/reviews).
   class Review < APIResource
     extend Stripe::APIOperations::List
 
     OBJECT_NAME = "review"
 
-    custom_method :approve, http_verb: :post
-
     def approve(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: resource_url + "/approve",
+        path: format("/v1/reviews/%<review>s/approve", { review: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.approve(review, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/reviews/%<review>s/approve", { review: CGI.escape(review) }),
         params: params,
         opts: opts
       )

data/lib/stripe/resources/setup_attempt.rb

@@ -2,6 +2,10 @@
 # frozen_string_literal: true
 
 module Stripe
+  # A SetupAttempt describes one attempted confirmation of a SetupIntent,
+  # whether that confirmation was successful or unsuccessful. You can use
+  # SetupAttempts to inspect details of a specific attempt at setting up a
+  # payment method using a SetupIntent.
   class SetupAttempt < APIResource
     extend Stripe::APIOperations::List
 

data/lib/stripe/resources/setup_intent.rb

@@ -2,6 +2,28 @@
 # frozen_string_literal: true
 
 module Stripe
+  # A SetupIntent guides you through the process of setting up and saving a customer's payment credentials for future payments.
+  # For example, you could use a SetupIntent to set up and save your customer's card without immediately collecting a payment.
+  # Later, you can use [PaymentIntents](https://stripe.com/docs/api#payment_intents) to drive the payment flow.
+  #
+  # Create a SetupIntent as soon as you're ready to collect your customer's payment credentials.
+  # Do not maintain long-lived, unconfirmed SetupIntents as they may no longer be valid.
+  # The SetupIntent then transitions through multiple [statuses](https://stripe.com/docs/payments/intents#intent-statuses) as it guides
+  # you through the setup process.
+  #
+  # Successful SetupIntents result in payment credentials that are optimized for future payments.
+  # For example, cardholders in [certain regions](https://stripe.com/guides/strong-customer-authentication) may need to be run through
+  # [Strong Customer Authentication](https://stripe.com/docs/strong-customer-authentication) at the time of payment method collection
+  # in order to streamline later [off-session payments](https://stripe.com/docs/payments/setup-intents).
+  # If the SetupIntent is used with a [Customer](https://stripe.com/docs/api#setup_intent_object-customer), upon success,
+  # it will automatically attach the resulting payment method to that Customer.
+  # We recommend using SetupIntents or [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage) on
+  # PaymentIntents to save payment methods in order to prevent saving invalid or unoptimized payment methods.
+  #
+  # By using SetupIntents, you ensure that your customers experience the minimum set of required friction,
+  # even as regulations change over time.
+  #
+  # Related guide: [Setup Intents API](https://stripe.com/docs/payments/setup-intents).
   class SetupIntent < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List
@@ -9,14 +31,10 @@ module Stripe
 
     OBJECT_NAME = "setup_intent"
 
-    custom_method :cancel, http_verb: :post
-    custom_method :confirm, http_verb: :post
-    custom_method :verify_microdeposits, http_verb: :post
-
     def cancel(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: resource_url + "/cancel",
+        path: format("/v1/setup_intents/%<intent>s/cancel", { intent: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
@@ -25,7 +43,7 @@ module Stripe
     def confirm(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: resource_url + "/confirm",
+        path: format("/v1/setup_intents/%<intent>s/confirm", { intent: CGI.escape(self["id"]) }),
         params: params,
         opts: opts
       )
@@ -34,7 +52,34 @@ module Stripe
     def verify_microdeposits(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: resource_url + "/verify_microdeposits",
+        path: format("/v1/setup_intents/%<intent>s/verify_microdeposits", { intent: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.cancel(intent, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/setup_intents/%<intent>s/cancel", { intent: CGI.escape(intent) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.confirm(intent, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/setup_intents/%<intent>s/confirm", { intent: CGI.escape(intent) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.verify_microdeposits(intent, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/setup_intents/%<intent>s/verify_microdeposits", { intent: CGI.escape(intent) }),
         params: params,
         opts: opts
       )

data/lib/stripe/resources/shipping_rate.rb

@@ -2,6 +2,9 @@
 # frozen_string_literal: true
 
 module Stripe
+  # Shipping rates describe the price of shipping presented to your customers and can be
+  # applied to [Checkout Sessions](https://stripe.com/docs/payments/checkout/shipping)
+  # and [Orders](https://stripe.com/docs/orders/shipping) to collect shipping costs.
   class ShippingRate < APIResource
     extend Stripe::APIOperations::Create
     extend Stripe::APIOperations::List

data/lib/stripe/resources/sigma/scheduled_query_run.rb

@@ -3,6 +3,10 @@
 
 module Stripe
   module Sigma
+    # If you have [scheduled a Sigma query](https://stripe.com/docs/sigma/scheduled-queries), you'll
+    # receive a `sigma.scheduled_query_run.created` webhook each time the query
+    # runs. The webhook contains a `ScheduledQueryRun` object, which you can use to
+    # retrieve the query results.
     class ScheduledQueryRun < APIResource
       extend Stripe::APIOperations::List
 

data/lib/stripe/resources/source.rb

@@ -2,6 +2,16 @@
 # frozen_string_literal: true
 
 module Stripe
+  # `Source` objects allow you to accept a variety of payment methods. They
+  # represent a customer's payment instrument, and can be used with the Stripe API
+  # just like a `Card` object: once chargeable, they can be charged, or can be
+  # attached to customers.
+  #
+  # Stripe doesn't recommend using the deprecated [Sources API](https://stripe.com/docs/api/sources).
+  # We recommend that you adopt the [PaymentMethods API](https://stripe.com/docs/api/payment_methods).
+  # This newer API provides access to our latest features and payment method types.
+  #
+  # Related guides: [Sources API](https://stripe.com/docs/sources) and [Sources & Customers](https://stripe.com/docs/sources/customers).
   class Source < APIResource
     extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Save
@@ -9,15 +19,22 @@ module Stripe
 
     OBJECT_NAME = "source"
 
-    custom_method :verify, http_verb: :post
-
     nested_resource_class_methods :source_transaction,
                                   operations: %i[retrieve list]
 
     def verify(params = {}, opts = {})
       request_stripe_object(
         method: :post,
-        path: resource_url + "/verify",
+        path: format("/v1/sources/%<source>s/verify", { source: CGI.escape(self["id"]) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.verify(source, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/sources/%<source>s/verify", { source: CGI.escape(source) }),
         params: params,
         opts: opts
       )
@@ -37,9 +54,12 @@ module Stripe
     end
 
     def source_transactions(params = {}, opts = {})
-      resp, opts = execute_resource_request(:get, resource_url + "/source_transactions", params,
-                                            opts)
-      Util.convert_to_stripe_object(resp.data, opts)
+      request_stripe_object(
+        method: :get,
+        path: resource_url + "/source_transactions",
+        params: params,
+        opts: opts
+      )
     end
     extend Gem::Deprecate
     deprecate :source_transactions, :"Source.list_source_transactions", 2020, 1

data/lib/stripe/resources/source_transaction.rb

@@ -2,6 +2,10 @@
 # frozen_string_literal: true
 
 module Stripe
+  # Some payment methods have no required amount that a customer must send.
+  # Customers can be instructed to send any amount, and it can be made up of
+  # multiple transactions. As such, sources can have multiple associated
+  # transactions.
   class SourceTransaction < StripeObject
     OBJECT_NAME = "source_transaction"
   end