Add runtime support for V2 int64 string-encoded fields

[mbroshi-stripe]

Why?

V2 APIs represent int64 fields as JSON strings on the wire (e.g. "12345" instead of 12345) to avoid precision loss. The SDK should transparently convert between native Python int and this wire format so users don't need to handle string encoding themselves.

What?

• Added _coerce_v2_params() and _coerce_value() to stripe/_encode.py for request-side coercion (int → str), handling scalars, nested objects, and arrays
• Added _field_encodings class variable and _coerce_field_value() method to StripeObject for response-side coercion (str → int) during _refresh_from
• Added tests covering top-level, nested, array, nullable, and mixed-field scenarios for both request and response paths

[xavdid-stripe]

This makes sense, but will likely conflict with #1762 (at a git and/or logical level). Also I don't think your fancier function actually gets used, so either it's not needed or should be wired up (or I misread)

[Copilot]

Pull request overview

Adds runtime coercion for V2 int64_string fields so SDK users can work with native Python int values while V2 JSON wire format uses strings.

Changes:

• Introduces request-side param coercion in stripe/_encode.py via _coerce_v2_params() / _coerce_value() and a shared helper _coerce_int64_string().
• Adds response-side field coercion to StripeObject._refresh_from() via _field_encodings + _coerce_field_value().
• Adds a dedicated test suite covering request/response coercion scenarios.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
stripe/_encode.py	Implements request coercion and shared int64_string conversion helper.
stripe/_stripe_service.py	Wires request coercion into service request paths via _param_encodings.
stripe/_stripe_object.py	Adds response hydration coercion via _field_encodings in _refresh_from.
tests/test_int64_string.py	Adds unit tests for both request serialization and response hydration coercion.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.