stripe 19.7.0.pre.beta.1 → 20.0.0

data/lib/stripe/events/unknown_event_notification.rb

@@ -1,4 +1,3 @@
-# File copied from our code generator; changes here will be overwritten.
 # frozen_string_literal: true
 
 require "stripe/resources/v2/core/event_notification"

data/lib/stripe/events/v1_account_application_authorized_event.rb

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs whenever a user authorizes an application. Sent to the related application only.
+    class V1AccountApplicationAuthorizedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v1.account.application.authorized"
+      end
+    end
+
+    # Occurs whenever a user authorizes an application. Sent to the related application only.
+    class V1AccountApplicationAuthorizedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v1.account.application.authorized"
+      end
+    end
+  end
+end

data/lib/stripe/events/v1_account_application_deauthorized_event.rb

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs whenever a user deauthorizes an application. Sent to the related application only.
+    class V1AccountApplicationDeauthorizedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v1.account.application.deauthorized"
+      end
+    end
+
+    # Occurs whenever a user deauthorizes an application. Sent to the related application only.
+    class V1AccountApplicationDeauthorizedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v1.account.application.deauthorized"
+      end
+    end
+  end
+end

data/lib/stripe/events/v1_account_external_account_created_event.rb

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs whenever an external account is created.
+    class V1AccountExternalAccountCreatedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v1.account.external_account.created"
+      end
+    end
+
+    # Occurs whenever an external account is created.
+    class V1AccountExternalAccountCreatedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v1.account.external_account.created"
+      end
+    end
+  end
+end

data/lib/stripe/events/v1_account_external_account_deleted_event.rb

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs whenever an external account is deleted.
+    class V1AccountExternalAccountDeletedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v1.account.external_account.deleted"
+      end
+    end
+
+    # Occurs whenever an external account is deleted.
+    class V1AccountExternalAccountDeletedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v1.account.external_account.deleted"
+      end
+    end
+  end
+end

data/lib/stripe/events/v1_account_external_account_updated_event.rb

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs whenever an external account is updated.
+    class V1AccountExternalAccountUpdatedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v1.account.external_account.updated"
+      end
+    end
+
+    # Occurs whenever an external account is updated.
+    class V1AccountExternalAccountUpdatedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v1.account.external_account.updated"
+      end
+    end
+  end
+end

data/lib/stripe/events/{v2_core_account_including_configuration_money_manager_updated_event.rb → v1_account_updated_event.rb}

@@ -3,10 +3,10 @@
 
 module Stripe
   module Events
-    # Occurs when a MoneyManager's configuration is updated.
-    class V2CoreAccountIncludingConfigurationMoneyManagerUpdatedEvent < Stripe::V2::Core::Event
+    # Occurs whenever an account status or property has changed.
+    class V1AccountUpdatedEvent < Stripe::V2::Core::Event
       def self.lookup_type
-        "v2.core.account[configuration.money_manager].updated"
+        "v1.account.updated"
       end
 
       # Retrieves the related object from the API. Makes an API request on every call.
@@ -21,10 +21,10 @@ module Stripe
       attr_reader :related_object
     end
 
-    # Occurs when a MoneyManager's configuration is updated.
-    class V2CoreAccountIncludingConfigurationMoneyManagerUpdatedEventNotification < Stripe::V2::Core::EventNotification
+    # Occurs whenever an account status or property has changed.
+    class V1AccountUpdatedEventNotification < Stripe::V2::Core::EventNotification
       def self.lookup_type
-        "v2.core.account[configuration.money_manager].updated"
+        "v1.account.updated"
       end
 
       attr_reader :related_object

data/lib/stripe/events/{v2_money_management_received_credit_succeeded_event.rb → v1_application_fee_created_event.rb}

@@ -3,10 +3,10 @@
 
 module Stripe
   module Events
-    # Occurs when a ReceivedCredit succeeds.
-    class V2MoneyManagementReceivedCreditSucceededEvent < Stripe::V2::Core::Event
+    # Occurs whenever an application fee is created on a charge.
+    class V1ApplicationFeeCreatedEvent < Stripe::V2::Core::Event
       def self.lookup_type
-        "v2.money_management.received_credit.succeeded"
+        "v1.application_fee.created"
       end
 
       # Retrieves the related object from the API. Makes an API request on every call.
@@ -21,15 +21,15 @@ module Stripe
       attr_reader :related_object
     end
 
-    # Occurs when a ReceivedCredit succeeds.
-    class V2MoneyManagementReceivedCreditSucceededEventNotification < Stripe::V2::Core::EventNotification
+    # Occurs whenever an application fee is created on a charge.
+    class V1ApplicationFeeCreatedEventNotification < Stripe::V2::Core::EventNotification
       def self.lookup_type
-        "v2.money_management.received_credit.succeeded"
+        "v1.application_fee.created"
       end
 
       attr_reader :related_object
 
-      # Retrieves the ReceivedCredit related to this EventNotification from the Stripe API. Makes an API request on every call.
+      # Retrieves the ApplicationFee related to this EventNotification from the Stripe API. Makes an API request on every call.
       def fetch_related_object
         resp = @client.raw_request(
           :get,

data/lib/stripe/events/{v2_core_approval_request_rejected_event.rb → v1_application_fee_refund_updated_event.rb}

@@ -3,10 +3,10 @@
 
 module Stripe
   module Events
-    # Occurs when an approval request is rejected by a reviewer.
-    class V2CoreApprovalRequestRejectedEvent < Stripe::V2::Core::Event
+    # Occurs whenever an application fee refund is updated.
+    class V1ApplicationFeeRefundUpdatedEvent < Stripe::V2::Core::Event
       def self.lookup_type
-        "v2.core.approval_request.rejected"
+        "v1.application_fee.refund.updated"
       end
 
       # Retrieves the related object from the API. Makes an API request on every call.
@@ -21,15 +21,15 @@ module Stripe
       attr_reader :related_object
     end
 
-    # Occurs when an approval request is rejected by a reviewer.
-    class V2CoreApprovalRequestRejectedEventNotification < Stripe::V2::Core::EventNotification
+    # Occurs whenever an application fee refund is updated.
+    class V1ApplicationFeeRefundUpdatedEventNotification < Stripe::V2::Core::EventNotification
       def self.lookup_type
-        "v2.core.approval_request.rejected"
+        "v1.application_fee.refund.updated"
       end
 
       attr_reader :related_object
 
-      # Retrieves the ApprovalRequest related to this EventNotification from the Stripe API. Makes an API request on every call.
+      # Retrieves the ApplicationFeeRefund related to this EventNotification from the Stripe API. Makes an API request on every call.
       def fetch_related_object
         resp = @client.raw_request(
           :get,

data/lib/stripe/events/{v2_money_management_received_credit_failed_event.rb → v1_application_fee_refunded_event.rb}

@@ -3,10 +3,10 @@
 
 module Stripe
   module Events
-    # Occurs when a ReceivedCredit is attempted to your balance and fails. See the status_details for more information.
-    class V2MoneyManagementReceivedCreditFailedEvent < Stripe::V2::Core::Event
+    # Occurs whenever an application fee is refunded, whether from refunding a charge or from [refunding the application fee directly](https://docs.stripe.com/api#fee_refunds). This includes partial refunds.
+    class V1ApplicationFeeRefundedEvent < Stripe::V2::Core::Event
       def self.lookup_type
-        "v2.money_management.received_credit.failed"
+        "v1.application_fee.refunded"
       end
 
       # Retrieves the related object from the API. Makes an API request on every call.
@@ -21,15 +21,15 @@ module Stripe
       attr_reader :related_object
     end
 
-    # Occurs when a ReceivedCredit is attempted to your balance and fails. See the status_details for more information.
-    class V2MoneyManagementReceivedCreditFailedEventNotification < Stripe::V2::Core::EventNotification
+    # Occurs whenever an application fee is refunded, whether from refunding a charge or from [refunding the application fee directly](https://docs.stripe.com/api#fee_refunds). This includes partial refunds.
+    class V1ApplicationFeeRefundedEventNotification < Stripe::V2::Core::EventNotification
       def self.lookup_type
-        "v2.money_management.received_credit.failed"
+        "v1.application_fee.refunded"
       end
 
       attr_reader :related_object
 
-      # Retrieves the ReceivedCredit related to this EventNotification from the Stripe API. Makes an API request on every call.
+      # Retrieves the ApplicationFee related to this EventNotification from the Stripe API. Makes an API request on every call.
       def fetch_related_object
         resp = @client.raw_request(
           :get,

data/lib/stripe/events/v1_balance_available_event.rb

@@ -0,0 +1,46 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs whenever your Stripe balance has been updated (e.g., when a charge is available to be paid out). By default, Stripe automatically transfers funds in your balance to your bank account on a daily basis. This event is not fired for negative transactions.
+    class V1BalanceAvailableEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v1.balance.available"
+      end
+
+      # Retrieves the related object from the API. Makes an API request on every call.
+      def fetch_related_object
+        _request(
+          method: :get,
+          path: related_object.url,
+          base_address: :api,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" }
+        )
+      end
+      attr_reader :related_object
+    end
+
+    # Occurs whenever your Stripe balance has been updated (e.g., when a charge is available to be paid out). By default, Stripe automatically transfers funds in your balance to your bank account on a daily basis. This event is not fired for negative transactions.
+    class V1BalanceAvailableEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v1.balance.available"
+      end
+
+      attr_reader :related_object
+      private def related_object_class
+        Stripe::V2::Core::RelatedSingletonObject
+      end
+      # Retrieves the Balance related to this EventNotification from the Stripe API. Makes an API request on every call.
+      def fetch_related_object
+        resp = @client.raw_request(
+          :get,
+          related_object.url,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" },
+          usage: ["fetch_related_object"]
+        )
+        @client.deserialize(resp.http_body, api_mode: Util.get_api_mode(related_object.url))
+      end
+    end
+  end
+end

data/lib/stripe/events/{v2_core_approval_request_expired_event.rb → v1_balance_settings_updated_event.rb}

@@ -3,10 +3,10 @@
 
 module Stripe
   module Events
-    # Occurs when an approval request expires without being acted upon.
-    class V2CoreApprovalRequestExpiredEvent < Stripe::V2::Core::Event
+    # Occurs whenever a balance settings status or property has changed.
+    class V1BalanceSettingsUpdatedEvent < Stripe::V2::Core::Event
       def self.lookup_type
-        "v2.core.approval_request.expired"
+        "v1.balance_settings.updated"
       end
 
       # Retrieves the related object from the API. Makes an API request on every call.
@@ -21,15 +21,17 @@ module Stripe
       attr_reader :related_object
     end
 
-    # Occurs when an approval request expires without being acted upon.
-    class V2CoreApprovalRequestExpiredEventNotification < Stripe::V2::Core::EventNotification
+    # Occurs whenever a balance settings status or property has changed.
+    class V1BalanceSettingsUpdatedEventNotification < Stripe::V2::Core::EventNotification
       def self.lookup_type
-        "v2.core.approval_request.expired"
+        "v1.balance_settings.updated"
       end
 
       attr_reader :related_object
-
-      # Retrieves the ApprovalRequest related to this EventNotification from the Stripe API. Makes an API request on every call.
+      private def related_object_class
+        Stripe::V2::Core::RelatedSingletonObject
+      end
+      # Retrieves the BalanceSettings related to this EventNotification from the Stripe API. Makes an API request on every call.
       def fetch_related_object
         resp = @client.raw_request(
           :get,

data/lib/stripe/events/v1_billing_alert_triggered_event.rb

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs whenever your custom alert threshold is met.
+    class V1BillingAlertTriggeredEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v1.billing.alert.triggered"
+      end
+
+      # Retrieves the related object from the API. Makes an API request on every call.
+      def fetch_related_object
+        _request(
+          method: :get,
+          path: related_object.url,
+          base_address: :api,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" }
+        )
+      end
+      attr_reader :related_object
+    end
+
+    # Occurs whenever your custom alert threshold is met.
+    class V1BillingAlertTriggeredEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v1.billing.alert.triggered"
+      end
+
+      attr_reader :related_object
+
+      # Retrieves the Alert related to this EventNotification from the Stripe API. Makes an API request on every call.
+      def fetch_related_object
+        resp = @client.raw_request(
+          :get,
+          related_object.url,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" },
+          usage: ["fetch_related_object"]
+        )
+        @client.deserialize(resp.http_body, api_mode: Util.get_api_mode(related_object.url))
+      end
+    end
+  end
+end

data/lib/stripe/events/{v2_money_management_financial_account_created_event.rb → v1_billing_credit_balance_transaction_created_event.rb}

@@ -3,10 +3,10 @@
 
 module Stripe
   module Events
-    # Occurs when a FinancialAccount is created.
-    class V2MoneyManagementFinancialAccountCreatedEvent < Stripe::V2::Core::Event
+    # Occurs when a credit balance transaction is created.
+    class V1BillingCreditBalanceTransactionCreatedEvent < Stripe::V2::Core::Event
       def self.lookup_type
-        "v2.money_management.financial_account.created"
+        "v1.billing.credit_balance_transaction.created"
       end
 
       # Retrieves the related object from the API. Makes an API request on every call.
@@ -21,15 +21,15 @@ module Stripe
       attr_reader :related_object
     end
 
-    # Occurs when a FinancialAccount is created.
-    class V2MoneyManagementFinancialAccountCreatedEventNotification < Stripe::V2::Core::EventNotification
+    # Occurs when a credit balance transaction is created.
+    class V1BillingCreditBalanceTransactionCreatedEventNotification < Stripe::V2::Core::EventNotification
       def self.lookup_type
-        "v2.money_management.financial_account.created"
+        "v1.billing.credit_balance_transaction.created"
       end
 
       attr_reader :related_object
 
-      # Retrieves the FinancialAccount related to this EventNotification from the Stripe API. Makes an API request on every call.
+      # Retrieves the CreditBalanceTransaction related to this EventNotification from the Stripe API. Makes an API request on every call.
       def fetch_related_object
         resp = @client.raw_request(
           :get,

data/lib/stripe/events/{v2_extend_workflow_run_succeeded_event.rb → v1_billing_credit_grant_created_event.rb}

@@ -3,10 +3,10 @@
 
 module Stripe
   module Events
-    # Occurs when a Workflow Run succeeds.
-    class V2ExtendWorkflowRunSucceededEvent < Stripe::V2::Core::Event
+    # Occurs when a credit grant is created.
+    class V1BillingCreditGrantCreatedEvent < Stripe::V2::Core::Event
       def self.lookup_type
-        "v2.extend.workflow_run.succeeded"
+        "v1.billing.credit_grant.created"
       end
 
       # Retrieves the related object from the API. Makes an API request on every call.
@@ -21,15 +21,15 @@ module Stripe
       attr_reader :related_object
     end
 
-    # Occurs when a Workflow Run succeeds.
-    class V2ExtendWorkflowRunSucceededEventNotification < Stripe::V2::Core::EventNotification
+    # Occurs when a credit grant is created.
+    class V1BillingCreditGrantCreatedEventNotification < Stripe::V2::Core::EventNotification
       def self.lookup_type
-        "v2.extend.workflow_run.succeeded"
+        "v1.billing.credit_grant.created"
       end
 
       attr_reader :related_object
 
-      # Retrieves the WorkflowRun related to this EventNotification from the Stripe API. Makes an API request on every call.
+      # Retrieves the CreditGrant related to this EventNotification from the Stripe API. Makes an API request on every call.
       def fetch_related_object
         resp = @client.raw_request(
           :get,

data/lib/stripe/events/{v2_core_batch_job_upload_timeout_event.rb → v1_billing_credit_grant_updated_event.rb}

@@ -3,10 +3,10 @@
 
 module Stripe
   module Events
-    # Occurs when merchant fails to upload a file in time.
-    class V2CoreBatchJobUploadTimeoutEvent < Stripe::V2::Core::Event
+    # Occurs when a credit grant is updated.
+    class V1BillingCreditGrantUpdatedEvent < Stripe::V2::Core::Event
       def self.lookup_type
-        "v2.core.batch_job.upload_timeout"
+        "v1.billing.credit_grant.updated"
       end
 
       # Retrieves the related object from the API. Makes an API request on every call.
@@ -21,15 +21,15 @@ module Stripe
       attr_reader :related_object
     end
 
-    # Occurs when merchant fails to upload a file in time.
-    class V2CoreBatchJobUploadTimeoutEventNotification < Stripe::V2::Core::EventNotification
+    # Occurs when a credit grant is updated.
+    class V1BillingCreditGrantUpdatedEventNotification < Stripe::V2::Core::EventNotification
       def self.lookup_type
-        "v2.core.batch_job.upload_timeout"
+        "v1.billing.credit_grant.updated"
       end
 
       attr_reader :related_object
 
-      # Retrieves the BatchJob related to this EventNotification from the Stripe API. Makes an API request on every call.
+      # Retrieves the CreditGrant related to this EventNotification from the Stripe API. Makes an API request on every call.
       def fetch_related_object
         resp = @client.raw_request(
           :get,

data/lib/stripe/events/v1_billing_meter_created_event.rb

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs when a meter is created.
+    class V1BillingMeterCreatedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v1.billing.meter.created"
+      end
+
+      # Retrieves the related object from the API. Makes an API request on every call.
+      def fetch_related_object
+        _request(
+          method: :get,
+          path: related_object.url,
+          base_address: :api,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" }
+        )
+      end
+      attr_reader :related_object
+    end
+
+    # Occurs when a meter is created.
+    class V1BillingMeterCreatedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v1.billing.meter.created"
+      end
+
+      attr_reader :related_object
+
+      # Retrieves the Meter related to this EventNotification from the Stripe API. Makes an API request on every call.
+      def fetch_related_object
+        resp = @client.raw_request(
+          :get,
+          related_object.url,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" },
+          usage: ["fetch_related_object"]
+        )
+        @client.deserialize(resp.http_body, api_mode: Util.get_api_mode(related_object.url))
+      end
+    end
+  end
+end

data/lib/stripe/events/v1_billing_meter_deactivated_event.rb

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs when a meter is deactivated.
+    class V1BillingMeterDeactivatedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v1.billing.meter.deactivated"
+      end
+
+      # Retrieves the related object from the API. Makes an API request on every call.
+      def fetch_related_object
+        _request(
+          method: :get,
+          path: related_object.url,
+          base_address: :api,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" }
+        )
+      end
+      attr_reader :related_object
+    end
+
+    # Occurs when a meter is deactivated.
+    class V1BillingMeterDeactivatedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v1.billing.meter.deactivated"
+      end
+
+      attr_reader :related_object
+
+      # Retrieves the Meter related to this EventNotification from the Stripe API. Makes an API request on every call.
+      def fetch_related_object
+        resp = @client.raw_request(
+          :get,
+          related_object.url,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" },
+          usage: ["fetch_related_object"]
+        )
+        @client.deserialize(resp.http_body, api_mode: Util.get_api_mode(related_object.url))
+      end
+    end
+  end
+end

data/lib/stripe/events/v1_billing_meter_reactivated_event.rb

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs when a meter is reactivated.
+    class V1BillingMeterReactivatedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v1.billing.meter.reactivated"
+      end
+
+      # Retrieves the related object from the API. Makes an API request on every call.
+      def fetch_related_object
+        _request(
+          method: :get,
+          path: related_object.url,
+          base_address: :api,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" }
+        )
+      end
+      attr_reader :related_object
+    end
+
+    # Occurs when a meter is reactivated.
+    class V1BillingMeterReactivatedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v1.billing.meter.reactivated"
+      end
+
+      attr_reader :related_object
+
+      # Retrieves the Meter related to this EventNotification from the Stripe API. Makes an API request on every call.
+      def fetch_related_object
+        resp = @client.raw_request(
+          :get,
+          related_object.url,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" },
+          usage: ["fetch_related_object"]
+        )
+        @client.deserialize(resp.http_body, api_mode: Util.get_api_mode(related_object.url))
+      end
+    end
+  end
+end

data/lib/stripe/events/v1_billing_meter_updated_event.rb

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Events
+    # Occurs when a meter is updated.
+    class V1BillingMeterUpdatedEvent < Stripe::V2::Core::Event
+      def self.lookup_type
+        "v1.billing.meter.updated"
+      end
+
+      # Retrieves the related object from the API. Makes an API request on every call.
+      def fetch_related_object
+        _request(
+          method: :get,
+          path: related_object.url,
+          base_address: :api,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" }
+        )
+      end
+      attr_reader :related_object
+    end
+
+    # Occurs when a meter is updated.
+    class V1BillingMeterUpdatedEventNotification < Stripe::V2::Core::EventNotification
+      def self.lookup_type
+        "v1.billing.meter.updated"
+      end
+
+      attr_reader :related_object
+
+      # Retrieves the Meter related to this EventNotification from the Stripe API. Makes an API request on every call.
+      def fetch_related_object
+        resp = @client.raw_request(
+          :get,
+          related_object.url,
+          opts: { stripe_context: context, "Stripe-Request-Trigger": "event=#{id}" },
+          usage: ["fetch_related_object"]
+        )
+        @client.deserialize(resp.http_body, api_mode: Util.get_api_mode(related_object.url))
+      end
+    end
+  end
+end