Add API v2 Search support

[jar-stripe]

Why?

API v2 Search returns v2.search_result pages and paginates by sending the original request body with POST requests to next_page_url. stripe-ruby needs a registered enumerable result object so generated v2 Search methods support normal object conversion and automatic iteration.

What?

• Adds and registers Stripe::V2::SearchResultObject.
• Exposes v2 Search results through Enumerable.
• Adds POST auto-pagination that preserves filters and request options, handles empty pages, and supports early termination.
• Adds focused conversion and v2 Search result coverage.

For the reviewer

v2 search requests look a lot like v1 search requests, except we use a POST instead of a GET and limit is lifted out of the body into the query params.

v2 search responses look a lot like v2 list responses except we have to remove limit from the POST request body.

See Also

https://go/j/DEVSDK-3316

Configuration

• skip-changefile: This PR is not a user-facing change, so there's no changefile.

[Copilot]

🟡 Changes recommended

Typed request parameters currently fail, and pagination can use the wrong API requestor.

2 open findings

• Use the deserialized result's bound requestor for pagination · New
• Convert typed search params to a hash before checking key presence · New

What changed in this PR

Adds API v2 Search result conversion and POST-based automatic pagination.

Changes:

• Registers Stripe::V2::SearchResultObject.
• Adds enumerable pagination preserving search filters.
• Moves Search limit parameters into the query string.

File	Description
.hark/​changes/​2026-10-08_jar_v2-search-support.change.md	Records the feature change.
lib/​stripe.rb	Loads the new result class.
lib/​stripe/​object_types.rb	Registers its object type.
lib/​stripe/​stripe_service.rb	Handles v2 Search limits.
lib/​stripe/​util.rb	Converts and initializes search results.
lib/​stripe/​v2_search_result_object.rb	Implements pagination and enumeration.
test/​stripe/​v2_search_result_object_test.rb	Tests POST pagination across empty pages.

🧠 Review effort: Balanced

---

Give feedback about Copilot approvals in this survey to enter a drawing for a $150 gift card.