[jar-stripe]

Why?

API v2 Search returns typed v2.search_result collections and paginates by sending the original request parameters with POST requests to next_page_url. stripe-php needs a registered Search result collection and a service request hook for generated v2 Search methods.

What?

• Adds and registers the generic API v2 SearchResult collection.
• Adds the generated-service request hook for v2 Search methods.
• Adds POST auto-pagination while preserving the original request parameters and options.
• Adds focused conversion and v2 Search result pagination 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

Auto-pagination can fail at runtime, null parameters are not handled, and the interface-breaking change has the wrong semver classification.

3 open findings

• Define baseUrl fallback for auto-pagination · New
• Normalize null pagination parameters before array access · New
• Classify required interface method addition as major · New

What changed in this PR

Adds API v2 Search result conversion, request handling, and POST-based auto-pagination.

Changes:

• Registers the new V2\SearchResult type.
• Adds v2 Search request hooks and limit handling.
• Adds conversion and pagination tests.

File	Description
lib/​V2/​SearchResult.php	Implements v2 Search collections and pagination.
lib/​Util/​ObjectTypes.php	Registers the response object type.
lib/​StripeClientInterface.php	Adds the v2 Search request contract.
lib/​Service/​AbstractService.php	Adds the generated-service request hook.
lib/​BaseStripeClient.php	Handles v2 Search requests and limits.
init.php	Loads the new class.
tests/​Stripe/​V2/​SearchResultTest.php	Tests conversion and pagination.
.hark/​changes/​2026-10-08_jar_v2-search-support.change.md	Documents the change.

🧠 Review effort: Balanced

---

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