stripe 19.4.0.pre.alpha.2 → 19.4.0.pre.alpha.3

data/lib/stripe/resources.rb

@@ -642,6 +642,16 @@ module Stripe
     autoload :V2BillingCadenceCanceledEventNotification, "stripe/events/v2_billing_cadence_canceled_event"
     autoload :V2BillingCadenceCreatedEvent, "stripe/events/v2_billing_cadence_created_event"
     autoload :V2BillingCadenceCreatedEventNotification, "stripe/events/v2_billing_cadence_created_event"
+    autoload :V2BillingContractActivatedEvent, "stripe/events/v2_billing_contract_activated_event"
+    autoload :V2BillingContractActivatedEventNotification, "stripe/events/v2_billing_contract_activated_event"
+    autoload :V2BillingContractCanceledEvent, "stripe/events/v2_billing_contract_canceled_event"
+    autoload :V2BillingContractCanceledEventNotification, "stripe/events/v2_billing_contract_canceled_event"
+    autoload :V2BillingContractCreatedEvent, "stripe/events/v2_billing_contract_created_event"
+    autoload :V2BillingContractCreatedEventNotification, "stripe/events/v2_billing_contract_created_event"
+    autoload :V2BillingContractEndedEvent, "stripe/events/v2_billing_contract_ended_event"
+    autoload :V2BillingContractEndedEventNotification, "stripe/events/v2_billing_contract_ended_event"
+    autoload :V2BillingContractUpdatedEvent, "stripe/events/v2_billing_contract_updated_event"
+    autoload :V2BillingContractUpdatedEventNotification, "stripe/events/v2_billing_contract_updated_event"
     autoload :V2BillingLicensedItemCreatedEvent, "stripe/events/v2_billing_licensed_item_created_event"
     autoload :V2BillingLicensedItemCreatedEventNotification, "stripe/events/v2_billing_licensed_item_created_event"
     autoload :V2BillingLicensedItemUpdatedEvent, "stripe/events/v2_billing_licensed_item_updated_event"
@@ -2074,6 +2084,11 @@ module Stripe
     stripe/events/v2_billing_cadence_billed_event
     stripe/events/v2_billing_cadence_canceled_event
     stripe/events/v2_billing_cadence_created_event
+    stripe/events/v2_billing_contract_activated_event
+    stripe/events/v2_billing_contract_canceled_event
+    stripe/events/v2_billing_contract_created_event
+    stripe/events/v2_billing_contract_ended_event
+    stripe/events/v2_billing_contract_updated_event
     stripe/events/v2_billing_license_fee_created_event
     stripe/events/v2_billing_license_fee_updated_event
     stripe/events/v2_billing_license_fee_version_created_event

data/lib/stripe/services/account_service.rb

@@ -17,7 +17,7 @@ module Stripe
     # With [Connect](https://docs.stripe.com/docs/connect), you can create Stripe accounts for your users.
     # To do this, you'll first need to [register your platform](https://dashboard.stripe.com/account/applications/settings).
     #
-    # If you've already collected information for your connected accounts, you [can prefill that information](https://docs.stripe.com/docs/connect/best-practices#onboarding) when
+    # If you've already collected information for your connected accounts, you [can prefill that information](https://docs.stripe.com/connect/marketplace/tasks/create#prefill-account-information) when
     # creating the account. Connect Onboarding won't ask for the prefilled information during account onboarding.
     # You can prefill any information on the account.
     def create(params = {}, opts = {})

data/lib/stripe/services/dispute_service.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   class DisputeService < StripeService
-    # Closing the dispute for a charge indicates that you do not have any evidence to submit and are essentially dismissing the dispute, acknowledging it as lost.
+    # Closing the dispute for a charge indicates that you do not have any evidence to submit and are essentially dismissing the dispute (accepting it), acknowledging it as lost.
     #
     # The status of the dispute will change from needs_response to lost. Closing a dispute is irreversible.
     def close(dispute, params = {}, opts = {})

data/lib/stripe/services/terminal/reader_service.rb

@@ -4,6 +4,17 @@
 module Stripe
   module Terminal
     class ReaderService < StripeService
+      # Initiates a gift card activation flow on a Reader and optionally sets its balance.
+      def activate_gift_card(reader, params = {}, opts = {})
+        request(
+          method: :post,
+          path: format("/v1/terminal/readers/%<reader>s/activate_gift_card", { reader: CGI.escape(reader) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
       # Cancels the current reader action. See [Programmatic Cancellation](https://docs.stripe.com/docs/terminal/payments/collect-card-payment?terminal-sdk-platform=server-driven#programmatic-cancellation) for more details.
       def cancel_action(reader, params = {}, opts = {})
         request(
@@ -15,6 +26,28 @@ module Stripe
         )
       end
 
+      # Initiates a gift card cashout flow on a Reader. A cashout sets the gift card balance to 0.
+      def cashout_gift_card(reader, params = {}, opts = {})
+        request(
+          method: :post,
+          path: format("/v1/terminal/readers/%<reader>s/cashout_gift_card", { reader: CGI.escape(reader) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
+      # Initiates a gift card balance check flow on a Reader.
+      def check_gift_card_balance(reader, params = {}, opts = {})
+        request(
+          method: :post,
+          path: format("/v1/terminal/readers/%<reader>s/check_gift_card_balance", { reader: CGI.escape(reader) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
       # Initiates an [input collection flow](https://docs.stripe.com/docs/terminal/features/collect-inputs) on a Reader to display input forms and collect information from your customers.
       def collect_inputs(reader, params = {}, opts = {})
         request(
@@ -114,6 +147,17 @@ module Stripe
         )
       end
 
+      # Initiates a gift card reload flow on a Reader by adding the specified amount to its balance.
+      def reload_gift_card(reader, params = {}, opts = {})
+        request(
+          method: :post,
+          path: format("/v1/terminal/readers/%<reader>s/reload_gift_card", { reader: CGI.escape(reader) }),
+          params: params,
+          opts: opts,
+          base_address: :api
+        )
+      end
+
       # Retrieves a Reader object.
       def retrieve(reader, params = {}, opts = {})
         request(

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

@@ -12,7 +12,7 @@ module Stripe
           @pricing_lines = Stripe::V2::Billing::Contracts::PricingLinesService.new(@requestor)
         end
 
-        # Activate a Draft Contract object by ID.
+        # Activate a draft contract.
         def activate(id, params = {}, opts = {})
           request(
             method: :post,
@@ -23,7 +23,7 @@ module Stripe
           )
         end
 
-        # Cancel a Contract object by ID.
+        # Cancel an active contract.
         def cancel(id, params = {}, opts = {})
           request(
             method: :post,
@@ -34,7 +34,7 @@ module Stripe
           )
         end
 
-        # Create a Contract object.
+        # Create a draft contract.
         def create(params = {}, opts = {})
           unless params.is_a?(Stripe::RequestParams)
             params = ::Stripe::V2::Billing::ContractCreateParams.coerce_params(params)
@@ -49,7 +49,7 @@ module Stripe
           )
         end
 
-        # Delete a draft Contract object by ID.
+        # Delete a draft contract.
         def delete(id, params = {}, opts = {})
           request(
             method: :delete,
@@ -60,7 +60,7 @@ module Stripe
           )
         end
 
-        # List Contract objects with pagination.
+        # List contracts.
         def list(params = {}, opts = {})
           request(
             method: :get,
@@ -71,7 +71,7 @@ module Stripe
           )
         end
 
-        # Retrieve a Contract object by ID.
+        # Retrieve a contract.
         def retrieve(id, params = {}, opts = {})
           request(
             method: :get,
@@ -82,7 +82,7 @@ module Stripe
           )
         end
 
-        # Update a Contract object by ID.
+        # Update a draft or active contract.
         def update(id, params = {}, opts = {})
           unless params.is_a?(Stripe::RequestParams)
             params = ::Stripe::V2::Billing::ContractUpdateParams.coerce_params(params)

data/lib/stripe/stripe_event_notification_handler.rb

@@ -1304,6 +1304,36 @@ module Stripe
       register("v2.billing.cadence.created", &handler)
     end
 
+    def on_v2_billing_contract_activated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.billing.contract.activated", &handler)
+    end
+
+    def on_v2_billing_contract_canceled(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.billing.contract.canceled", &handler)
+    end
+
+    def on_v2_billing_contract_created(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.billing.contract.created", &handler)
+    end
+
+    def on_v2_billing_contract_ended(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.billing.contract.ended", &handler)
+    end
+
+    def on_v2_billing_contract_updated(&handler)
+      raise ArgumentError, "Block required to register event handler" if handler.nil?
+
+      register("v2.billing.contract.updated", &handler)
+    end
+
     def on_v2_billing_license_fee_created(&handler)
       raise ArgumentError, "Block required to register event handler" if handler.nil?
 

data/lib/stripe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Stripe
-  VERSION = "19.4.0-alpha.2"
+  VERSION = "19.4.0-alpha.3"
 end