Makes Boleto tax ID nullable in payment method details for Payment Records
What’s new
Updates the payment_method_details.boleto.tax_id field to be nullable on the Payment Record and Payment Attempt Record objects. Previously, this field always returned a string value. You can still provide the tax ID when recording Boleto payments, but it’s no longer required.
Impact
If your integration reads the tax_id from payment_method_details.boleto on Payment Record or Payment Attempt Record objects, it can now return null. Update any code that assumes this field is always present to handle a null value.
Changes
| Fields | Change | From → to |
|---|---|---|
| PaymentAttemptRecord. payment_method_details. boleto. tax_id PaymentRecord. payment_method_details. boleto. tax_id | Changed | string → nullable(string) |
Upgrade
- View your current API version in Workbench.
- If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2026-02-25. clover
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.