v13.1.0-beta.2

• #1468 Update generated code for beta
  • Add support for submit_card test helper method on resource Issuing.Card

See the changelog for more details.

v13.1.0-beta.1

• #1465 Updates to the Preview class
  • Remove Stripe::Preview. Use StripeClient#raw_request instead (see below).
  • Marked Stripe.raw_request and Stripe.deserialize as deprecated. Use StripeClient#raw_request and StripeClient#deserialize instead. In StripeClient, the params and opts parameters are passed as keyword arguments:

    # Before
    resp = Stripe.raw_request(:post, "v1/charges", , {p1: "p1"}, {stripe_account: "acct_123"})
    charge = Stripe.deserialize(resp.data)
    
    # After
    client = StripeClient.new("sk_test_123") 
    resp = client.raw_request(:post, "/v1/charges", params: {p1: "p1"}, opts: {stripe_account: "acct_123"})
    charge = client.deserialize(resp.data)

See the changelog for more details.

v13.0.0

• #1458 Support for APIs in the new API version 2024-09-30.acacia

  This release changes the pinned API version to 2024-09-30.acacia. Please read the API Upgrade Guide and carefully review the API changes before upgrading.

  ⚠️ Breaking changes

  Please refer to our migration guide for v13 for more information about the backwards incompatible changes.

  ❗ StripeClient and related changes

  • Move StripeClient and requestor logic to APIRequestor.
    • StripeClient#request is still available, but is deprecated and will be removed. We encourage StripeClient#raw_request as a replacement (see other breaking changes for more detail).
  • Repurpose and introduce StripeClient as the the entry-point to the service-based pattern, a new interface for calling the Stripe API with many benefits over the existing resource-based paradigm. Services are available under the v1 and v2 accessors.
    • No global config: you can simultaneously use multiple clients with different configuration options (such as API keys)
    • No extra API calls. All API endpoints can be accessed with a single method call. You don't have to call retrieve before doing an update.
    • No static methods. Much easier mocking.

  Other breaking changes

  • Adjust default values around retries for HTTP requests. You can use the old defaults by setting them explicitly. New values are:
    • max retries: 0 -> 2
    • max retry delay (seconds) 2 -> 5
  • Remove StripeClient#connection_manager. This was a legacy method from years ago.
  • Singleton retrieve method now requires params to be passed as the first argument. Existing calls to singleton retrieve method with only opts argument will have to be updated to account for the addition of params argument.

    params = { expand: ["available"] }
    opts = { stripe_account: "acct_123" }
    
    # ❌ No longer works
    Stripe::Balance.retrieve(opts)
    
    # ✅ Correct way to call retrieve method
    Stripe::Balance.retrieve(params, opts)

  • Moved the Stripe.raw_request() method that was recently added to StripeClient. This will use the configuration set on the StripeClient instead of the global configuration used before.
  • Remove APIResource.request. Instead, use StripeClient#raw_request now.

    # Instead of
    Stripe::APIResource.request(:get, "/v1/endpoint", params, opts)
    
    # do
    client = Stripe::StripeClient.new(...)
    resp = client.raw_request(:get, "/v1/endpoint", params: params, opts: opts)

  • Add an additional parameter to APIResource.execute_resource_request. However, we discourage use of this in favor of StripeClient#raw_request.

    APIResource.execute_resource_request(method, url, params = {}, opts = {}, usage = [])
    # is now, with base_address being one of [:api, :files, :connect, :meter_events]
    APIResource.execute_resource_request(method, url, base_address = :api, params = {}, opts = {}, usage = [])

  • Change parameters to APIRequestor.execute_request (previously StripeClient.execute_request). It now returns all request options from our internal request framework as the second value in the returned tuple, instead of only the API key used:

    # Before
    obj, api_key = StripeClient.execute_request(method, path, api_base: nil,
                                                api_key: nil, headers: {}, params: {}, usage: [])
    
    # is now, with base_address being one of [:api, :files, :connect, :meter_events]
    
    obj, opts = APIRequestor.execute_request(method, path, base_address,
                                            params: {}, opts: {}, usage: [])
    puts(opts) # will output {api_key: "sk_test_123", stripe_account: "acct_123"}

  Additions

  • Add support for new Usage Billing APIs Billing.MeterEvent, Billing.MeterEventAdjustments, Billing.MeterEventSession, Billing.MeterEventStream and the new Events API Core.Events in the v2 namespace
  • Add method parse_thin_event() on the StripeClient class to parse thin events.

See the changelog for more details.

v12.7.0-beta.2

• #1449 Update generated code for beta
  • Remove support for resource QuotePhase
  • Remove support for list_line_items and retrieve methods on resource QuotePhase

See the changelog for more details.

v12.7.0-beta.1

• #1446 Update generated code for beta
  • Add support for new resources Issuing.DisputeSettlementDetail and Issuing.Settlement
  • Add support for list and retrieve methods on resource DisputeSettlementDetail
  • Remove support for list method on resource QuotePhase

See the changelog for more details.

v12.6.0

• #1442 Update generated code
  • Add support for new resource InvoiceRenderingTemplate
  • Add support for archive, list, retrieve, and unarchive methods on resource InvoiceRenderingTemplate
• #1443 Removed v1/files override

See the changelog for more details.

v12.6.0-beta.1

• #1441 Update generated code for beta
  • Add support for new resources Billing.MeterErrorReport and Terminal.ReaderCollectedData
  • Add support for retrieve method on resource ReaderCollectedData

See the changelog for more details.

v12.5.0

• #1440 Update generated code
  • Add support for new resources Billing.AlertTriggered and Billing.Alert
  • Add support for activate, archive, create, deactivate, list, and retrieve methods on resource Alert
  • Add support for retrieve method on resource Tax.Calculation

See the changelog for more details.

v12.5.0-beta.2

• #1439 Update generated code for beta
  • Add support for attach_payment method on resource Invoice

See the changelog for more details.

v12.5.0-beta.1

• #1429 Update generated code for beta
  • Add support for new resources Billing.AlertTriggered, Billing.Alert, and Tax.Association
  • Add support for activate, archive, create, deactivate, list, and retrieve methods on resource Alert
  • Add support for find method on resource Association
• #1434 Merge changes from stripe/stripe-ruby master

See the changelog for more details.