- Breaking changes
- Public preview
Adds under review status events for outbound payments and transfers Breaking changes Public preview
What’s new
You can now subscribe to the outbound_payment.under_review and outbound_transfer.under_review events on the OutboundPayment and OutboundTransfer resources. These events are triggered when we place an outbound payment or transfer on hold for internal review.
You can also identify the held state through the new under_review reason in the processing status detail on both resources when reading the object directly. Two new failure reason enum values, fx_rate_drift_exceeded_after_review and review_rejected, indicate why a payment or transfer failed after the review period concluded.
Why is this a breaking change?
Previously, there was no way to determine why an outbound payment or transfer was taking longer than expected in the processing status.
Impact
You can now determine why an outbound payment or transfer is taking longer than expected in the processing status. status_details.processing provides context, such as the under_review reason, when an outbound payment or transfer is held for review.
Handle the new outbound_payment.under_review and outbound_transfer.under_review events to be notified immediately when an outbound payment or transfer is placed on hold for review. Update any code that evaluates failure reasons to handle the new fx_rate_drift_exceeded_after_review and review_rejected enum values to avoid unexpected behavior when a payment or transfer fails after review.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| processing | Added | V2. MoneyManagement. OutboundPayment. status_details V2. MoneyManagement. OutboundTransfer. status_details |
| Values | Change | Enums |
| fx_rate_drift_exceeded_after_review review_rejected | Added | V2. MoneyManagement. OutboundPayment. status_details. failed. reason V2. MoneyManagement. OutboundTransfer. status_details. failed. reason |
| Change | Event types | |
| V2MoneyManagementOutboundPaymentUnderReviewEvent | Added | V2.MoneyManagement.OutboundPayment |
| V2MoneyManagementOutboundTransferUnderReviewEvent | Added | V2.MoneyManagement.OutboundTransfer |
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-06-24. preview
- 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.