stripe 10.5.0.pre.beta.1 → 10.6.0.pre.beta.1

data/lib/stripe/resources/payout.rb

@@ -17,6 +17,7 @@ module Stripe
 
     OBJECT_NAME = "payout"
 
+    # You can cancel a previously created payout if it hasn't been paid out yet. Stripe refunds the funds to your available balance. You can't cancel automatic Stripe payouts.
     def cancel(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -26,6 +27,9 @@ 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 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(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -35,6 +39,7 @@ module Stripe
       )
     end
 
+    # You can cancel a previously created payout if it hasn't been paid out yet. Stripe refunds the funds to your available balance. You can't cancel automatic Stripe payouts.
     def self.cancel(payout, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -44,6 +49,9 @@ 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 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 self.reverse(payout, params = {}, opts = {})
       request_stripe_object(
         method: :post,

data/lib/stripe/resources/quote.rb

@@ -15,6 +15,7 @@ module Stripe
     nested_resource_class_methods :preview_invoice, operations: %i[list]
     nested_resource_class_methods :preview_subscription_schedule, operations: %i[list]
 
+    # Accepts the specified quote.
     def accept(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -24,6 +25,7 @@ module Stripe
       )
     end
 
+    # Cancels the quote.
     def cancel(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -33,6 +35,7 @@ module Stripe
       )
     end
 
+    # Finalizes the quote.
     def finalize_quote(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -42,6 +45,7 @@ module Stripe
       )
     end
 
+    # When retrieving a quote, there is an includable [computed.upfront.line_items](https://stripe.com/docs/api/quotes/object#quote_object-computed-upfront-line_items) property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of upfront line items.
     def list_computed_upfront_line_items(params = {}, opts = {})
       request_stripe_object(
         method: :get,
@@ -51,6 +55,7 @@ module Stripe
       )
     end
 
+    # When retrieving a quote, there is an includable line_items property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
     def list_line_items(params = {}, opts = {})
       request_stripe_object(
         method: :get,
@@ -60,6 +65,7 @@ module Stripe
       )
     end
 
+    # Retrieves a paginated list of lines for a quote. These lines describe changes that will be used to create new subscription schedules or update existing subscription schedules when the quote is accepted.
     def list_lines(params = {}, opts = {})
       request_stripe_object(
         method: :get,
@@ -69,6 +75,7 @@ module Stripe
       )
     end
 
+    # Preview the invoice line items that would be generated by accepting the quote.
     def list_preview_invoice_lines(preview_invoice, params = {}, opts = {})
       request_stripe_object(
         method: :get,
@@ -78,6 +85,7 @@ module Stripe
       )
     end
 
+    # Converts a stale quote to draft.
     def mark_draft(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -87,6 +95,7 @@ module Stripe
       )
     end
 
+    # Converts a draft or open quote to stale.
     def mark_stale(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -96,6 +105,7 @@ module Stripe
       )
     end
 
+    # Download the PDF for a finalized quote
     def pdf(params = {}, opts = {}, &read_body_chunk_block)
       config = opts[:client]&.config || Stripe.config
       opts = { api_base: config.uploads_base }.merge(opts)
@@ -108,6 +118,7 @@ module Stripe
       )
     end
 
+    # Recompute the upcoming invoice estimate for the quote.
     def reestimate(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -117,6 +128,7 @@ module Stripe
       )
     end
 
+    # Accepts the specified quote.
     def self.accept(quote, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -126,6 +138,7 @@ module Stripe
       )
     end
 
+    # Cancels the quote.
     def self.cancel(quote, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -135,6 +148,7 @@ module Stripe
       )
     end
 
+    # Finalizes the quote.
     def self.finalize_quote(quote, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -144,6 +158,7 @@ module Stripe
       )
     end
 
+    # When retrieving a quote, there is an includable [computed.upfront.line_items](https://stripe.com/docs/api/quotes/object#quote_object-computed-upfront-line_items) property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of upfront line items.
     def self.list_computed_upfront_line_items(quote, params = {}, opts = {})
       request_stripe_object(
         method: :get,
@@ -153,6 +168,7 @@ module Stripe
       )
     end
 
+    # When retrieving a quote, there is an includable line_items property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
     def self.list_line_items(quote, params = {}, opts = {})
       request_stripe_object(
         method: :get,
@@ -162,6 +178,7 @@ module Stripe
       )
     end
 
+    # Retrieves a paginated list of lines for a quote. These lines describe changes that will be used to create new subscription schedules or update existing subscription schedules when the quote is accepted.
     def self.list_lines(quote, params = {}, opts = {})
       request_stripe_object(
         method: :get,
@@ -171,6 +188,7 @@ module Stripe
       )
     end
 
+    # Preview the invoice line items that would be generated by accepting the quote.
     def self.list_preview_invoice_lines(quote, preview_invoice, params = {}, opts = {})
       request_stripe_object(
         method: :get,
@@ -180,6 +198,7 @@ module Stripe
       )
     end
 
+    # Converts a stale quote to draft.
     def self.mark_draft(quote, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -189,6 +208,7 @@ module Stripe
       )
     end
 
+    # Converts a draft or open quote to stale.
     def self.mark_stale(quote, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -198,6 +218,7 @@ module Stripe
       )
     end
 
+    # Download the PDF for a finalized quote
     def self.pdf(quote, params = {}, opts = {}, &read_body_chunk_block)
       config = opts[:client]&.config || Stripe.config
       opts = { api_base: config.uploads_base }.merge(opts)
@@ -210,6 +231,7 @@ module Stripe
       )
     end
 
+    # Recompute the upcoming invoice estimate for the quote.
     def self.reestimate(quote, params = {}, opts = {})
       request_stripe_object(
         method: :post,

data/lib/stripe/resources/quote_phase.rb

@@ -8,6 +8,7 @@ module Stripe
 
     OBJECT_NAME = "quote_phase"
 
+    # When retrieving a quote phase, there is an includable line_items property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
     def list_line_items(params = {}, opts = {})
       request_stripe_object(
         method: :get,
@@ -17,6 +18,7 @@ module Stripe
       )
     end
 
+    # When retrieving a quote phase, there is an includable line_items property containing the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
     def self.list_line_items(quote_phase, params = {}, opts = {})
       request_stripe_object(
         method: :get,

data/lib/stripe/resources/refund.rb

@@ -14,6 +14,9 @@ module Stripe
 
     OBJECT_NAME = "refund"
 
+    # Cancels a refund with a status of requires_action.
+    #
+    # You can't cancel refunds in other states. Only refunds for payment methods that require customer action can enter the requires_action state.
     def cancel(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -23,6 +26,9 @@ module Stripe
       )
     end
 
+    # Cancels a refund with a status of requires_action.
+    #
+    # You can't cancel refunds in other states. Only refunds for payment methods that require customer action can enter the requires_action state.
     def self.cancel(refund, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -39,6 +45,7 @@ module Stripe
     class TestHelpers < APIResourceTestHelpers
       RESOURCE_CLASS = Refund
 
+      # Expire a refund with a status of requires_action.
       def self.expire(refund, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -48,6 +55,7 @@ module Stripe
         )
       end
 
+      # Expire a refund with a status of requires_action.
       def expire(params = {}, opts = {})
         @resource.request_stripe_object(
           method: :post,

data/lib/stripe/resources/review.rb

@@ -11,6 +11,7 @@ module Stripe
 
     OBJECT_NAME = "review"
 
+    # Approves a Review object, closing it and removing it from the list of reviews.
     def approve(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -20,6 +21,7 @@ module Stripe
       )
     end
 
+    # Approves a Review object, closing it and removing it from the list of reviews.
     def self.approve(review, params = {}, opts = {})
       request_stripe_object(
         method: :post,

data/lib/stripe/resources/setup_intent.rb

@@ -30,6 +30,9 @@ module Stripe
 
     OBJECT_NAME = "setup_intent"
 
+    # You can cancel a SetupIntent object when it's in one of these statuses: requires_payment_method, requires_confirmation, or requires_action.
+    #
+    # After you cancel it, setup is abandoned and any operations on the SetupIntent fail with an error.
     def cancel(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -39,6 +42,20 @@ module Stripe
       )
     end
 
+    # Confirm that your customer intends to set up the current or
+    # provided payment method. For example, you would confirm a SetupIntent
+    # when a customer hits the “Save” button on a payment method management
+    # page on your website.
+    #
+    # If the selected payment method does not require any additional
+    # steps from the customer, the SetupIntent will transition to the
+    # succeeded status.
+    #
+    # Otherwise, it will transition to the requires_action status and
+    # suggest additional actions via next_action. If setup fails,
+    # the SetupIntent will transition to the
+    # requires_payment_method status or the canceled status if the
+    # confirmation limit is reached.
     def confirm(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -48,6 +65,7 @@ module Stripe
       )
     end
 
+    # Verifies microdeposits on a SetupIntent object.
     def verify_microdeposits(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -57,6 +75,9 @@ module Stripe
       )
     end
 
+    # You can cancel a SetupIntent object when it's in one of these statuses: requires_payment_method, requires_confirmation, or requires_action.
+    #
+    # After you cancel it, setup is abandoned and any operations on the SetupIntent fail with an error.
     def self.cancel(intent, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -66,6 +87,20 @@ module Stripe
       )
     end
 
+    # Confirm that your customer intends to set up the current or
+    # provided payment method. For example, you would confirm a SetupIntent
+    # when a customer hits the “Save” button on a payment method management
+    # page on your website.
+    #
+    # If the selected payment method does not require any additional
+    # steps from the customer, the SetupIntent will transition to the
+    # succeeded status.
+    #
+    # Otherwise, it will transition to the requires_action status and
+    # suggest additional actions via next_action. If setup fails,
+    # the SetupIntent will transition to the
+    # requires_payment_method status or the canceled status if the
+    # confirmation limit is reached.
     def self.confirm(intent, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -75,6 +110,7 @@ module Stripe
       )
     end
 
+    # Verifies microdeposits on a SetupIntent object.
     def self.verify_microdeposits(intent, params = {}, opts = {})
       request_stripe_object(
         method: :post,

data/lib/stripe/resources/source.rb

@@ -21,6 +21,7 @@ module Stripe
 
     nested_resource_class_methods :source_transaction, operations: %i[retrieve list]
 
+    # Verify a given source.
     def verify(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -30,6 +31,7 @@ module Stripe
       )
     end
 
+    # Verify a given source.
     def self.verify(source, params = {}, opts = {})
       request_stripe_object(
         method: :post,

data/lib/stripe/resources/subscription.rb

@@ -13,6 +13,11 @@ module Stripe
 
     OBJECT_NAME = "subscription"
 
+    # Cancels a customer's subscription immediately. The customer will not be charged again for the subscription.
+    #
+    # Note, however, that any pending invoice items that you've created will still be charged for at the end of the period, unless manually [deleted](https://stripe.com/docs/api#delete_invoiceitem). If you've set the subscription to cancel at the end of the period, any pending prorations will also be left in place and collected at the end of the period. But if the subscription is set to cancel immediately, pending prorations will be removed.
+    #
+    # By default, upon subscription cancellation, Stripe will stop automatic collection of all finalized invoices for the customer. This is intended to prevent unexpected payment attempts after the customer has canceled a subscription. However, you can resume automatic collection of the invoices manually after subscription cancellation to have us proceed. Or, you could check for unpaid invoices before allowing the customer to cancel the subscription at all.
     def cancel(params = {}, opts = {})
       request_stripe_object(
         method: :delete,
@@ -22,6 +27,7 @@ module Stripe
       )
     end
 
+    # Removes the currently applied discount on a subscription.
     def delete_discount(params = {}, opts = {})
       request_stripe_object(
         method: :delete,
@@ -31,6 +37,7 @@ module Stripe
       )
     end
 
+    # Initiates resumption of a paused subscription, optionally resetting the billing cycle anchor and creating prorations. If a resumption invoice is generated, it must be paid or marked uncollectible before the subscription will be unpaused. If payment succeeds the subscription will become active, and if payment fails the subscription will be past_due. The resumption invoice will void automatically if not paid by the expiration date.
     def resume(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -40,6 +47,11 @@ module Stripe
       )
     end
 
+    # Cancels a customer's subscription immediately. The customer will not be charged again for the subscription.
+    #
+    # Note, however, that any pending invoice items that you've created will still be charged for at the end of the period, unless manually [deleted](https://stripe.com/docs/api#delete_invoiceitem). If you've set the subscription to cancel at the end of the period, any pending prorations will also be left in place and collected at the end of the period. But if the subscription is set to cancel immediately, pending prorations will be removed.
+    #
+    # By default, upon subscription cancellation, Stripe will stop automatic collection of all finalized invoices for the customer. This is intended to prevent unexpected payment attempts after the customer has canceled a subscription. However, you can resume automatic collection of the invoices manually after subscription cancellation to have us proceed. Or, you could check for unpaid invoices before allowing the customer to cancel the subscription at all.
     def self.cancel(subscription_exposed_id, params = {}, opts = {})
       request_stripe_object(
         method: :delete,
@@ -49,6 +61,7 @@ module Stripe
       )
     end
 
+    # Removes the currently applied discount on a subscription.
     def self.delete_discount(subscription_exposed_id, params = {}, opts = {})
       request_stripe_object(
         method: :delete,
@@ -58,6 +71,7 @@ module Stripe
       )
     end
 
+    # Initiates resumption of a paused subscription, optionally resetting the billing cycle anchor and creating prorations. If a resumption invoice is generated, it must be paid or marked uncollectible before the subscription will be unpaused. If payment succeeds the subscription will become active, and if payment fails the subscription will be past_due. The resumption invoice will void automatically if not paid by the expiration date.
     def self.resume(subscription, params = {}, opts = {})
       request_stripe_object(
         method: :post,

data/lib/stripe/resources/subscription_schedule.rb

@@ -12,6 +12,7 @@ module Stripe
 
     OBJECT_NAME = "subscription_schedule"
 
+    # Amends an existing subscription schedule.
     def amend(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -21,6 +22,7 @@ module Stripe
       )
     end
 
+    # Cancels a subscription schedule and its associated subscription immediately (if the subscription schedule has an active subscription). A subscription schedule can only be canceled if its status is not_started or active.
     def cancel(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -30,6 +32,7 @@ module Stripe
       )
     end
 
+    # Releases the subscription schedule immediately, which will stop scheduling of its phases, but leave any existing subscription in place. A schedule can only be released if its status is not_started or active. If the subscription schedule is currently associated with a subscription, releasing it will remove its subscription property and set the subscription's ID to the released_subscription property.
     def release(params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -39,6 +42,7 @@ module Stripe
       )
     end
 
+    # Amends an existing subscription schedule.
     def self.amend(schedule, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -48,6 +52,7 @@ module Stripe
       )
     end
 
+    # Cancels a subscription schedule and its associated subscription immediately (if the subscription schedule has an active subscription). A subscription schedule can only be canceled if its status is not_started or active.
     def self.cancel(schedule, params = {}, opts = {})
       request_stripe_object(
         method: :post,
@@ -57,6 +62,7 @@ module Stripe
       )
     end
 
+    # Releases the subscription schedule immediately, which will stop scheduling of its phases, but leave any existing subscription in place. A schedule can only be released if its status is not_started or active. If the subscription schedule is currently associated with a subscription, releasing it will remove its subscription property and set the subscription's ID to the released_subscription property.
     def self.release(schedule, params = {}, opts = {})
       request_stripe_object(
         method: :post,

data/lib/stripe/resources/tax/calculation.rb

@@ -11,6 +11,7 @@ module Stripe
 
       OBJECT_NAME = "tax.calculation"
 
+      # Retrieves the line items of a persisted tax calculation as a collection.
       def list_line_items(params = {}, opts = {})
         request_stripe_object(
           method: :get,
@@ -20,6 +21,7 @@ module Stripe
         )
       end
 
+      # Retrieves the line items of a persisted tax calculation as a collection.
       def self.list_line_items(calculation, params = {}, opts = {})
         request_stripe_object(
           method: :get,

data/lib/stripe/resources/tax/form.rb

@@ -11,6 +11,7 @@ module Stripe
 
       OBJECT_NAME = "tax.form"
 
+      # Download the PDF for a tax form.
       def pdf(params = {}, opts = {}, &read_body_chunk_block)
         config = opts[:client]&.config || Stripe.config
         opts = { api_base: config.uploads_base }.merge(opts)
@@ -23,6 +24,7 @@ module Stripe
         )
       end
 
+      # Download the PDF for a tax form.
       def self.pdf(id, params = {}, opts = {}, &read_body_chunk_block)
         config = opts[:client]&.config || Stripe.config
         opts = { api_base: config.uploads_base }.merge(opts)

data/lib/stripe/resources/tax/transaction.rb

@@ -9,6 +9,7 @@ module Stripe
     class Transaction < APIResource
       OBJECT_NAME = "tax.transaction"
 
+      # Retrieves the line items of a committed standalone transaction as a collection.
       def list_line_items(params = {}, opts = {})
         request_stripe_object(
           method: :get,
@@ -18,6 +19,7 @@ module Stripe
         )
       end
 
+      # Creates a Tax Transaction from a calculation.
       def self.create_from_calculation(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -27,6 +29,7 @@ module Stripe
         )
       end
 
+      # Partially or fully reverses a previously created Transaction.
       def self.create_reversal(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -36,6 +39,7 @@ module Stripe
         )
       end
 
+      # Retrieves the line items of a committed standalone transaction as a collection.
       def self.list_line_items(transaction, params = {}, opts = {})
         request_stripe_object(
           method: :get,

data/lib/stripe/resources/terminal/reader.rb

@@ -14,6 +14,7 @@ module Stripe
 
       OBJECT_NAME = "terminal.reader"
 
+      # Cancels the current reader action.
       def cancel_action(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -23,6 +24,7 @@ module Stripe
         )
       end
 
+      # Initiates an input collection flow on a Reader.
       def collect_inputs(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -32,6 +34,7 @@ module Stripe
         )
       end
 
+      # Initiates a payment flow on a Reader and updates the PaymentIntent with card details before manual confirmation.
       def collect_payment_method(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -41,6 +44,7 @@ module Stripe
         )
       end
 
+      # Finalizes a payment on a Reader.
       def confirm_payment_intent(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -50,6 +54,7 @@ module Stripe
         )
       end
 
+      # Initiates a payment flow on a Reader.
       def process_payment_intent(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -59,6 +64,7 @@ module Stripe
         )
       end
 
+      # Initiates a setup intent flow on a Reader.
       def process_setup_intent(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -68,6 +74,7 @@ module Stripe
         )
       end
 
+      # Initiates a refund on a Reader
       def refund_payment(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -77,6 +84,7 @@ module Stripe
         )
       end
 
+      # Sets reader display to show cart details.
       def set_reader_display(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -86,6 +94,7 @@ module Stripe
         )
       end
 
+      # Cancels the current reader action.
       def self.cancel_action(reader, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -95,6 +104,7 @@ module Stripe
         )
       end
 
+      # Initiates an input collection flow on a Reader.
       def self.collect_inputs(reader, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -104,6 +114,7 @@ module Stripe
         )
       end
 
+      # Initiates a payment flow on a Reader and updates the PaymentIntent with card details before manual confirmation.
       def self.collect_payment_method(reader, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -113,6 +124,7 @@ module Stripe
         )
       end
 
+      # Finalizes a payment on a Reader.
       def self.confirm_payment_intent(reader, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -122,6 +134,7 @@ module Stripe
         )
       end
 
+      # Initiates a payment flow on a Reader.
       def self.process_payment_intent(reader, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -131,6 +144,7 @@ module Stripe
         )
       end
 
+      # Initiates a setup intent flow on a Reader.
       def self.process_setup_intent(reader, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -140,6 +154,7 @@ module Stripe
         )
       end
 
+      # Initiates a refund on a Reader
       def self.refund_payment(reader, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -149,6 +164,7 @@ module Stripe
         )
       end
 
+      # Sets reader display to show cart details.
       def self.set_reader_display(reader, params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -165,6 +181,7 @@ module Stripe
       class TestHelpers < APIResourceTestHelpers
         RESOURCE_CLASS = Reader
 
+        # Presents a payment method on a simulated reader. Can be used to simulate accepting a payment, saving a card or refunding a transaction.
         def self.present_payment_method(reader, params = {}, opts = {})
           request_stripe_object(
             method: :post,
@@ -174,6 +191,7 @@ module Stripe
           )
         end
 
+        # Presents a payment method on a simulated reader. Can be used to simulate accepting a payment, saving a card or refunding a transaction.
         def present_payment_method(params = {}, opts = {})
           @resource.request_stripe_object(
             method: :post,

data/lib/stripe/resources/test_helpers/test_clock.rb

@@ -13,6 +13,7 @@ module Stripe
 
       OBJECT_NAME = "test_helpers.test_clock"
 
+      # Starts advancing a test clock to a specified time in the future. Advancement is done when status changes to Ready.
       def advance(params = {}, opts = {})
         request_stripe_object(
           method: :post,
@@ -22,6 +23,7 @@ module Stripe
         )
       end
 
+      # Starts advancing a test clock to a specified time in the future. Advancement is done when status changes to Ready.
       def self.advance(test_clock, params = {}, opts = {})
         request_stripe_object(
           method: :post,