stripe 19.1.0 → 19.2.0

data/lib/stripe/services/payment_intent_service.rb

@@ -134,7 +134,9 @@ module Stripe
     # Each PaymentIntent can have a maximum of 10 incremental authorization attempts, including declines.
     # After it's captured, a PaymentIntent can no longer be incremented.
     #
-    # Learn more about [incremental authorizations](https://docs.stripe.com/docs/terminal/features/incremental-authorizations).
+    # Learn more about incremental authorizations with
+    # [in-person payments](https://docs.stripe.com/docs/terminal/features/incremental-authorizations) and
+    # [online payments](https://docs.stripe.com/docs/payments/incremental-authorization?platform=web&ui=elements).
     def increment_authorization(intent, params = {}, opts = {})
       request(
         method: :post,

data/lib/stripe/services/subscription_service.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   class SubscriptionService < StripeService
-    # Cancels a customer's subscription immediately. The customer won't be charged again for the subscription. After it's canceled, you can no longer update the subscription or its [metadata](https://docs.stripe.com/metadata).
+    # Cancels a customer's subscription immediately. The customer won't be charged again for the subscription. After it's canceled, the subscription is largely immutable. You can still update its [metadata](https://docs.stripe.com/metadata) and cancellation_details.
     #
     # Any pending invoice items that you've created are still charged at the end of the period, unless manually [deleted](https://docs.stripe.com/api/invoiceitems/delete). If you've set the subscription to cancel at the end of the period, any pending prorations are also left in place and collected at the end of the period. But if the subscription is set to cancel immediately, pending prorations are removed if invoice_now and prorate are both set to true.
     #
@@ -70,7 +70,7 @@ module Stripe
       )
     end
 
-    # Initiates resumption of a paused subscription, optionally resetting the billing cycle anchor and creating prorations. If no resumption invoice is generated, the subscription becomes active immediately. If a resumption invoice is generated, the subscription remains paused until the invoice is paid or marked uncollectible. If the invoice isn't paid by the expiration date, it is voided and the subscription remains paused. You can only resume subscriptions with collection_method set to charge_automatically. send_invoice subscriptions are not supported.
+    # Initiates resumption of a paused subscription, optionally resetting the billing cycle anchor and creating prorations. Resume is only available for subscriptions that use charge_automatically collection. If Stripe doesn't generate a resumption invoice, the subscription becomes active immediately. When a resumption invoice is generated, Stripe finalizes it immediately. If the invoice is paid or marked uncollectible, the subscription becomes active. If the invoice is manually voided, the subscription stays paused. If there is no payment attempt within 23 hours, Stripe voids the invoice and the subscription stays paused. Learn more about [resuming subscriptions](https://docs.stripe.com/docs/billing/subscriptions/pause#resume-subscriptions).
     def resume(subscription, params = {}, opts = {})
       request(
         method: :post,

data/lib/stripe/services/v2/billing/meter_event_session_service.rb

@@ -5,7 +5,7 @@ module Stripe
   module V2
     module Billing
       class MeterEventSessionService < StripeService
-        # Creates a meter event session to send usage on the high-throughput meter event stream. Authentication tokens are only valid for 15 minutes, so you will need to create a new meter event session when your token expires.
+        # Creates a meter event session to send usage on the high-throughput meter event stream. Authentication tokens are only valid for 15 minutes, so you need to create a new meter event session when your token expires.
         def create(params = {}, opts = {})
           request(
             method: :post,

data/lib/stripe/services/v2/commerce/product_catalog/import_service.rb

@@ -0,0 +1,45 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Commerce
+      module ProductCatalog
+        class ImportService < StripeService
+          # Creates a ProductCatalogImport.
+          def create(params = {}, opts = {})
+            request(
+              method: :post,
+              path: "/v2/commerce/product_catalog/imports",
+              params: params,
+              opts: opts,
+              base_address: :api
+            )
+          end
+
+          # Returns a list of ProductCatalogImport objects.
+          def list(params = {}, opts = {})
+            request(
+              method: :get,
+              path: "/v2/commerce/product_catalog/imports",
+              params: params,
+              opts: opts,
+              base_address: :api
+            )
+          end
+
+          # Retrieves a ProductCatalogImport by ID.
+          def retrieve(id, params = {}, opts = {})
+            request(
+              method: :get,
+              path: format("/v2/commerce/product_catalog/imports/%<id>s", { id: CGI.escape(id) }),
+              params: params,
+              opts: opts,
+              base_address: :api
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/commerce/product_catalog_service.rb

@@ -0,0 +1,17 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    module Commerce
+      class ProductCatalogService < StripeService
+        attr_reader :imports
+
+        def initialize(requestor)
+          super
+          @imports = Stripe::V2::Commerce::ProductCatalog::ImportService.new(@requestor)
+        end
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/commerce_service.rb

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module V2
+    class CommerceService < StripeService
+      attr_reader :product_catalog
+
+      def initialize(requestor)
+        super
+        @product_catalog = Stripe::V2::Commerce::ProductCatalogService.new(@requestor)
+      end
+    end
+  end
+end

data/lib/stripe/services/v2/core/account_service.rb

@@ -26,7 +26,7 @@ module Stripe
           )
         end
 
-        # An Account is a representation of a company, individual or other entity that a user interacts with. Accounts contain identifying information about the entity, and configurations that store the features an account has access to. An account can be configured as any or all of the following configurations: Customer, Merchant and/or Recipient.
+        # Create an Account that represents a company, individual, or other entity that your business interacts with. Accounts contain identifying information about the entity, and configurations that store the features an account has access to. An account can be configured as any or all of the following configurations: Customer, Merchant and/or Recipient.
         #
         # ** raises RateLimitError
         def create(params = {}, opts = {})

data/lib/stripe/services/v2/core/account_token_service.rb

@@ -5,7 +5,11 @@ module Stripe
   module V2
     module Core
       class AccountTokenService < StripeService
-        # Creates an Account Token.
+        # Create an account token with a publishable key and pass it to the Accounts v2 API to
+        # create or update an account without its data touching your server.
+        # Learn more about [account tokens](https://docs.stripe.com/connect/account-tokens).
+        # In live mode, you can only create account tokens with your application's publishable key.
+        # In test mode, you can create account tokens with your secret key or publishable key.
         #
         # ** raises RateLimitError
         def create(params = {}, opts = {})

data/lib/stripe/services/v2/core/accounts/person_token_service.rb

@@ -6,7 +6,8 @@ module Stripe
     module Core
       module Accounts
         class PersonTokenService < StripeService
-          # Creates a Person Token associated with an Account.
+          # Creates a single-use token that represents the details for a person. Use this when you create or update persons associated with an Account v2. Learn more about [account tokens](https://docs.stripe.com/connect/account-tokens).
+          # You can only create person tokens with your application's publishable key and in live mode. You can use your application's secret key to create person tokens only in test mode.
           #
           # ** raises RateLimitError
           def create(account_id, params = {}, opts = {})

data/lib/stripe/services/v2/core/event_service.rb

@@ -16,7 +16,8 @@ module Stripe
           )
         end
 
-        # Retrieves the details of an event.
+        # Retrieves the details of an event if it was created in the last 30 days. Supply the unique
+        # identifier of the event, which might have been delivered to your event destination.
         def retrieve(id, params = {}, opts = {})
           request(
             method: :get,

data/lib/stripe/services/v2_services.rb

@@ -3,11 +3,12 @@
 
 module Stripe
   class V2Services < StripeService
-    attr_reader :billing, :core
+    attr_reader :billing, :commerce, :core
 
     def initialize(requestor)
       super
       @billing = Stripe::V2::BillingService.new(@requestor)
+      @commerce = Stripe::V2::CommerceService.new(@requestor)
       @core = Stripe::V2::CoreService.new(@requestor)
     end
   end