Overview

Stripe has updated the Payment Record and Payment Attempt Record objects to make the tax_id field in payment_method_details.boleto nullable. Previously, this property always returned a string value; now it can return null.

What Changed

The payment_method_details.boleto.tax_id property on Payment Record and Payment Attempt Record objects is now optional and nullable. You can still provide a tax ID when recording Boleto payments, but it's no longer a required field.

Developer Action Items

If your integration reads the tax_id from payment_method_details.boleto, you must update your code to handle null values:

• Review existing code that assumes this property is always present
• Add null checks before accessing or processing the tax_id value
• Test thoroughly against the new API version (2026-02-25.clover)
• Update webhooks to use the new API version
• Upgrade SDKs to the latest versions for your language (Ruby, Python, PHP, Java, Node.js, Go, .NET)

Upgrade Path

To adopt this change, use Stripe Workbench to view your current API version and perform the upgrade. The new API version can be rolled back for 72 hours if needed. Be sure to test your integration and Connect setup before finalizing the upgrade.