New settlement_type Property

Stripe has introduced the settlement_type property to Application Fee objects, providing developers with critical settlement information directly through the API. This property indicates whether fees are settled on a net or gross basis.

Settlement Type Values

The new property supports two distinct settlement models:

• net_settled: The fee is settled at charge time
• gross_settled: The fee is settled at the end of a billing cycle

Use Cases & Impact

This addition enables platform operators and ISVs to:

• Programmatically distinguish between different settlement types without external lookups
• Build more precise financial reporting and reconciliation systems
• Eliminate manual calculations previously required to determine settlement amounts
• Automate payment verification workflows with confidence

Previously, there was no way to retrieve this information directly from the API, forcing developers to rely on external systems or manual processes to understand fee settlement mechanics.

Upgrade Path

To access this feature, update your Stripe API version to 2026-02-25.clover or later:

• REST API: Include Stripe-Version: 2026-02-25.clover in your API requests
• SDK Users: Upgrade to the latest SDK version for your language (Ruby, Python, PHP, Java, Node.js, Go, or .NET)
• Webhooks: Ensure webhook endpoints use the new API version
• Testing: Validate your integration against the new version before production rollout

Stripe allows you to roll back your API version for 72 hours if needed.