stripe 13.1.0.pre.beta.2 → 13.1.0.pre.beta.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb3814708d697a6e7d081dfeec39b1d54b4e32abc163a83c5e2b5d4e9934d623
-  data.tar.gz: ba8c9d94f78eab694cf55148e04de09ad390bc039537093df7a1c31d4c11234b
+  metadata.gz: 8df19974cec6125de295484a1352d7a77300d303bb7116be8b2921007b4f022c
+  data.tar.gz: f56676ab8ed4ccbc50f4f12c69766b6bbfc178c87e52bbda6509705d33f42e5d
 SHA512:
-  metadata.gz: 1f135698dc89345728ec5d73991ea0de8d2507632a2ad94a7b3cbbef206bf7b7f51b9c067d548d930a4ff6c904e91b0a3d4024c168fed9edbb539005ec7b477a
-  data.tar.gz: fc3e2a7bf5f31f9ab9d7d2415099bd913f0b7f37067a13a8cf3720a4f572f388bb507ac7dd99cbed392d68bb98e6cff6ac53ff25c7899c479cdc25b1c701ecee
+  metadata.gz: 741cd9b30a6570dbea2fa5fdbd9f808d227562d06e9ce79ee85ad5814a77bb10081ae025c7366901ad27ebd35d5634c43455841baaf2a8bce26ae6f52af65e65
+  data.tar.gz: 7218eccfda405be061e98e50c7a9fcdcd329aa417afec190f552737ae34d135ba2681737b186b4a18c80c2355dde00ba6a1dc68b78759e88c36877792c509f70

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 13.1.0-beta.3 - 2024-10-18
+* [#1469](https://github.com/stripe/stripe-ruby/pull/1469) Update generated code for beta
+
+
 ## 13.1.0-beta.2 - 2024-10-08
 * [#1468](https://github.com/stripe/stripe-ruby/pull/1468) Update generated code for beta
   * Add support for `submit_card` test helper method on resource `Issuing.Card`

data/OPENAPI_VERSION

@@ -1 +1 @@
-v1273
+v1314

data/VERSION

@@ -1 +1 @@
-13.1.0-beta.2
+13.1.0-beta.3

data/examples/README.md

@@ -3,9 +3,14 @@
 From the examples folder, run:
 `RUBYLIB=../lib ruby your_example.rb`
 
+e.g.
+
+`RUBYLIB=../lib ruby thinevent_webhook_handler.rb`
+
 ## Adding a new example
 
 1. Clone new_example.rb
 2. Implement your example
-3. Run it (as per above)
-4. 👍
+3. Fill out the file comment. Include a description and key steps that are being demonstrated.
+4. Run it (as per above)
+5. 👍

data/examples/example_template.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+# example_template.py - This is a template for defining new examples.  It is not intended to be used directly.
+#
+# <describe what this example does>
+#
+# In this example, we:
+#   - <key step 1>
+#   - <key step 2
+#   - ...
+#
+# <describe assumptions about the user's stripe account, environment, or configuration;
+# or things to watch out for when running>
+
+require "stripe"
+require "date"
+
+class ExampleTemplate
+  attr_accessor :api_key
+
+  def initialize(api_key)
+    @api_key = api_key
+  end
+
+  def do_something_great
+    puts "Hello World"
+    # client = Stripe::StripeClient.new(api_key)
+    # client.v1
+  end
+end
+
+# Send meter events
+api_key = "{{API_KEY}}"
+
+example = ExampleTemplate.new(api_key)
+example.do_something_great

data/examples/meter_event_stream.rb

@@ -1,5 +1,15 @@
 # frozen_string_literal: true
 
+# meter_event_stream.py - use the high-throughput meter event stream to report create billing meter events.
+#
+# In this example, we:
+#   - create a meter event session and store the session's authentication token
+#   - define an event with a payload
+#   - use the meter_event_stream service accessor in StripeClient to create an event stream that reports this event
+#
+# This example expects a billing meter with an event_name of 'alpaca_ai_tokens'.  If you have
+# a different meter event name, you can change it before running this example.
+
 require "stripe"
 require "date"
 

data/examples/{stripe_webhook_handler.rb → thinevent_webhook_handler.rb}

@@ -1,6 +1,17 @@
 # frozen_string_literal: true
 # typed: false
 
+# thinevent_webhook_handler.rb - receive and process thin events like the
+# v1.billing.meter.error_report_triggered event.
+#
+# In this example, we:
+#     - create a StripeClient called client
+#     - use client.parse_thin_event to parse the received thin event webhook body
+#     - call client.v2.core.events.retrieve to retrieve the full event object
+#     - if it is a V1BillingMeterErrorReportTriggeredEvent event type, call
+#       event.fetchRelatedObject to retrieve the Billing Meter object associated
+#       with the event.
+
 require "stripe"
 require "sinatra"
 

data/lib/stripe/resources/billing/credit_balance_summary.rb

@@ -3,7 +3,7 @@
 
 module Stripe
   module Billing
-    # Indicates the credit balance for credits granted to a customer.
+    # Indicates the billing credit balance for billing credits granted to a customer.
     class CreditBalanceSummary < SingletonAPIResource
       OBJECT_NAME = "billing.credit_balance_summary"
       def self.object_name

data/lib/stripe/resources/billing/credit_grant.rb

@@ -3,7 +3,10 @@
 
 module Stripe
   module Billing
-    # A credit grant is a resource that records a grant of some credit to a customer.
+    # A credit grant is an API resource that documents the allocation of some billing credits to a customer.
+    #
+    # Related guide: [Billing credits](https://docs.stripe.com/billing/subscriptions/usage-based/billing-credits)
+    # end
     class CreditGrant < APIResource
       extend Stripe::APIOperations::Create
       extend Stripe::APIOperations::List

data/lib/stripe/resources/issuing/card.rb

@@ -124,7 +124,7 @@ module Stripe
           )
         end
 
-        # Updates the shipping status of the specified Issuing Card object to submitted. This method is only available with Stripe Version ‘2024-09-30.acacia' or above.
+        # Updates the shipping status of the specified Issuing Card object to submitted. This method requires Stripe Version ‘2024-09-30.acacia' or later.
         def self.submit_card(card, params = {}, opts = {})
           request_stripe_object(
             method: :post,
@@ -134,7 +134,7 @@ module Stripe
           )
         end
 
-        # Updates the shipping status of the specified Issuing Card object to submitted. This method is only available with Stripe Version ‘2024-09-30.acacia' or above.
+        # Updates the shipping status of the specified Issuing Card object to submitted. This method requires Stripe Version ‘2024-09-30.acacia' or later.
         def submit_card(params = {}, opts = {})
           @resource.request_stripe_object(
             method: :post,

data/lib/stripe/resources/token.rb

@@ -31,7 +31,7 @@ module Stripe
     end
 
     # Creates a single-use token that represents a bank account's details.
-    # You can use this token with any API method in place of a bank account dictionary. You can only use this token once. To do so, attach it to a [connected account](https://stripe.com/docs/api#accounts) where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is application, which includes Custom accounts.
+    # You can use this token with any v1 API method in place of a bank account dictionary. You can only use this token once. To do so, attach it to a [connected account](https://stripe.com/docs/api#accounts) where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is application, which includes Custom accounts.
     def self.create(params = {}, opts = {})
       request_stripe_object(method: :post, path: "/v1/tokens", params: params, opts: opts)
     end

data/lib/stripe/resources/v2/billing/meter_event.rb

@@ -6,9 +6,9 @@ module Stripe
     module Billing
       # Fix me empty_doc_string.
       class MeterEvent < APIResource
-        OBJECT_NAME = "billing.meter_event"
+        OBJECT_NAME = "v2.billing.meter_event"
         def self.object_name
-          "billing.meter_event"
+          "v2.billing.meter_event"
         end
       end
     end

data/lib/stripe/resources/v2/billing/meter_event_adjustment.rb

@@ -5,9 +5,9 @@ module Stripe
   module V2
     module Billing
       class MeterEventAdjustment < APIResource
-        OBJECT_NAME = "billing.meter_event_adjustment"
+        OBJECT_NAME = "v2.billing.meter_event_adjustment"
         def self.object_name
-          "billing.meter_event_adjustment"
+          "v2.billing.meter_event_adjustment"
         end
       end
     end

data/lib/stripe/resources/v2/billing/meter_event_session.rb

@@ -5,9 +5,9 @@ module Stripe
   module V2
     module Billing
       class MeterEventSession < APIResource
-        OBJECT_NAME = "billing.meter_event_session"
+        OBJECT_NAME = "v2.billing.meter_event_session"
         def self.object_name
-          "billing.meter_event_session"
+          "v2.billing.meter_event_session"
         end
       end
     end

data/lib/stripe/services/test_helpers/issuing/card_service.rb

@@ -49,7 +49,7 @@ module Stripe
           )
         end
 
-        # Updates the shipping status of the specified Issuing Card object to submitted. This method is only available with Stripe Version ‘2024-09-30.acacia' or above.
+        # Updates the shipping status of the specified Issuing Card object to submitted. This method requires Stripe Version ‘2024-09-30.acacia' or later.
         def submit_card(card, params = {}, opts = {})
           request(
             method: :post,

data/lib/stripe/services/token_service.rb

@@ -4,7 +4,7 @@
 module Stripe
   class TokenService < StripeService
     # Creates a single-use token that represents a bank account's details.
-    # You can use this token with any API method in place of a bank account dictionary. You can only use this token once. To do so, attach it to a [connected account](https://stripe.com/docs/api#accounts) where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is application, which includes Custom accounts.
+    # You can use this token with any v1 API method in place of a bank account dictionary. You can only use this token once. To do so, attach it to a [connected account](https://stripe.com/docs/api#accounts) where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is application, which includes Custom accounts.
     def create(params = {}, opts = {})
       request(method: :post, path: "/v1/tokens", params: params, opts: opts, base_address: :api)
     end

data/lib/stripe/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stripe
 version: !ruby/object:Gem::Version
-  version: 13.1.0.pre.beta.2
+  version: 13.1.0.pre.beta.3
 platform: ruby
 authors:
 - Stripe
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-10-08 00:00:00.000000000 Z
+date: 2024-10-18 00:00:00.000000000 Z
 dependencies: []
 description: Stripe is the easiest way to accept payments online.  See https://stripe.com
   for details.
@@ -30,9 +30,9 @@ files:
 - Rakefile
 - VERSION
 - examples/README.md
+- examples/example_template.rb
 - examples/meter_event_stream.rb
-- examples/new_example.rb
-- examples/stripe_webhook_handler.rb
+- examples/thinevent_webhook_handler.rb
 - exe/stripe-console
 - lib/data/ca-certificates.crt
 - lib/stripe.rb

data/examples/new_example.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-require "stripe"
-require "date"
-
-class NewExample
-  attr_accessor :api_key
-
-  def initialize(api_key)
-    @api_key = api_key
-  end
-
-  def do_something_great
-    puts "Hello World"
-    # client = Stripe::StripeClient.new(api_key)
-    # client.v1
-  end
-end
-
-# Send meter events
-api_key = "{{API_KEY}}"
-
-example = NewExample.new(api_key)
-example.do_something_great