New Field: email_customers_on_successful_payment

Stripe has introduced a new optional field to the settings.payments hash in the Accounts v1 API. The email_customers_on_successful_payment field enables platforms to configure automated email receipt behavior for their connected accounts without requiring manual Dashboard access.

Key Capabilities

• Programmatic control: Set email receipt preferences via API on create, update, and retrieve operations
• Dashboard parity: The field maps directly to existing email receipt functionality in Stripe Dashboard
• Platform-only: Only controlling platforms can modify this setting; connected accounts cannot set it directly on their own accounts
• Smart defaults: Defaults to false if not explicitly specified

Why This Matters

Platforms can now manage payment notification settings across their entire connected account ecosystem programmatically. This is particularly valuable for accounts without Dashboard access or when you want to enforce consistent notification policies across your network. Previously, these settings required manual configuration in the Dashboard.

Getting Started

To use this feature, upgrade to API version 2026-02-25.preview:

• Update your SDK to the latest version corresponding to this API version
• Alternatively, add Stripe-Version: 2026-02-25.preview header to REST API calls
• Test your integration and update webhook endpoint versions
• Use Workbench to perform the upgrade (72-hour rollback window available)