Thin webhook events don't respond to `object`

[jasonkarns]

Describe the bug

Using client.parse_event_notification to parse webhook events.

The payload is supposedly described here https://docs.stripe.com/api/v2/core/events

which documents a payload having: "object": "v2.core.event", property.

Indeed, the gem's own "V2" checking looks for :object -

stripe-ruby/lib/stripe/webhook.rb

Line 22 in 0b1d66f

if data[:object] == "v2.core.event"

So the expectation is that a webhook endpoint should be able to look:

(json_payload.dig(:object) || parsed_event.try(:object)) == "v2.core.event" to ascertain whether the webhook event is a V2 format or not.

Even a V2 ping is indicated as having an object property:

ping payload from events log

{
  "created": "2026-04-29T16:27:50.520Z",
  "id": "evt_test_65Uayv8cg97C3LFQYdF16TfJjvRiSQ3NDL3s0hpoTYO836",
  "object": "v2.core.event",
  "type": "v2.core.event_destination.ping",
  "data": {},
  "livemode": false,
  "reason": {
    "type": "request",
    "request": {
      "id": "req_v2fHbmB3KZ0nY2zzQ",
      "idempotency_key": "4ebc22f3-658e-35b3-b55a-6fa5d70cefc3"
    }
  },
  "related_object": {
    "id": "ed_test_61UaJd6BLMqoJDHXW16TfJjvRiSQ3NDL3s0hpoTYORvc",
    "type": "v2.core.event_destination",
    "url": "/v2/core/event_destinations/ed_test_61UaJd6BLMqoJDHXW16TfJjvRiSQ3NDL3s0hpoTYORvc"
  },
  "changes": null
}

And yet, the resulting parsed event object does not respond to object!!!

NoMethodError Exception: undefined method 'object' for an instance of Stripe::Events::V2CoreEventDestinationPingEventNotification

To Reproduce

1. Send V2 ping event.
2. parse with client.parse_event_notification
3. read parsed_event.object

Expected behavior

I expected .object to be a method on all objects and payloads, as indicated in the Stripe object docs and json samples.

That way we could have a simple and consistent way to ascertain whether an event object (or payload) is V1 or V2.

Feature request would be for the Stripe gem to have a utility method that we could just use directly.

Code snippets

OS

macos

Language version

3.1.4

Library version

18.4.1

API version

2026-02-25.clover

Additional context

No response

[xavdid]

That's a good point! The most correct way is to check if parsed_event.is_a(Stripe::V2::Core::EventNotification) but I agree that the inconsistency isn't great. I'll get that fixed, thanks for flagging!

[jasonkarns]

@xavdid But that will fail if the event is a "full" (non-thin) V2 event, right? And also, what would be the consistent way to check both against re-ified objects as well as json payloads?

The goal is to have a single, simple predicate method that can tell me wether the given argument is V1 or V2, and that it accepts both thin and full V2 events, snapshot V1 events, and all three in json/hash form. (That way the same check can be used directly on the incoming payload to determine how to parse. And also useful for webhooks that are persisted into the db via jsonb.)

[xavdid]

But that will fail if the event is a "full" (non-thin) V2 event, right?

It won't error, but it would return false, yeah. And that makes sense as a goal!

[jasonkarns]

It won't error, but it would return false, yeah.

Right. I mean "fail" in the sense of "fail to behave correctly". Because a full V2 event is still a V2 event.

Our current v1?/v2? looks something like this: (Does this look correct to you as best currently-available checks?)

      def v1?(event)
        (event.try(:object) || event.try(:dig, "object")) == "event"
      end

      def v2?(event)
        event.is_a?(::Stripe::V2::Core::EventNotification) || # thin event notification
          (event.try(:object) || event.try(:dig, "object")) == "v2.core.event"
      end

This breakdown makes the EventNotification case really stand out. (If this table is correct.)

And what makes this really confusing (which is why I opened this as a bug instead of a feature request) is because the event_notification json payload does indeed have "object": "v2.core.event". But the reified EventNotification instance just doesn't expose the object method accordingly.

type	form	interrogative
V1	Stripe::Event	.object method
V1	json/hash	"object" property
V2-full	Stripe::V2::Core::Event (+ subclasses)	.object method
V2-full	json/hash	"object" property
V2-thin	Stripe::V2::Core::EventNotification (+subclasses)	is_a? Stripe::V2::Core::EventNotification
V2-thin	json/hash	"object" property

[xavdid]

yep, I agree. Like I said, we'll get it fixed soon. 😄

Filed as DEVSDK-3101 internally

[japheth696]

Ok