Adds SDK support for trace IDs
What’s new
Adds SDK support for the trace_id field on the Payout object.
Banking partners create the trace ID for payouts. You can use these IDs to track missing or delayed payouts with your bank.
Impact
You can now access the payout trace_id using the Stripe SDK.
For Connect users, you can provide your connected accounts their trace IDs by retrieving a payout. Your connected accounts can then use that ID to self-serve their late or missing payouts without the need for manual support intervention.
Changes
| Field | Change | From → to |
|---|---|---|
| Payout. trace_id | Changed | optional → required |
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: 2024-12-18. acacia
- 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.