Configure the behavior of connected accountsPublic preview
Learn how to configure your connected accounts using the Accounts v2 API.
You define the interactions between your platform, connected accounts, and Stripe, such as funds flows and loss liability, by configuring your connected accounts. Set up your integration to configure them by specifying values for certain properties when it creates the corresponding Accounts v2 objects. For example, properties in the defaults.
hash assign liability for negative balances on your connected accounts and specify how Stripe collects payment fees.
The values you assign to your connected account properties also affect other aspects of your integration. For example, responsibility for verifying identity information is assigned to Stripe or your platform based on negative balance liability and connected accounts’ access to Stripe Dashboards.
Note
Responsibilities and the dashboard
property in Accounts v2 correspond to controller properties in Accounts v1. This document includes a map of controller properties to Accounts v2 properties.
Set responsibilities
You must define defaults.
properties when you add the Merchant configuration to an account. You can’t update their values later.
Property | Description | Values |
---|---|---|
defaults.responsibilities.fees_collector | Defines how Stripe collects payment fees for direct charges on the connected account. (For destination or separate charges, Stripe always collects fees from your platform.) |
|
defaults.responsibilities.losses_collector | Assigns responsibility for negative balances incurred by the connected account. |
|
Responsibilities are subject to the following restrictions:
- If you set
losses_
tocollector application
, then you must also setfees_
tocollector application
. - If you use destination charges with an Account, we recommend that you set both
losses_
andcollector fees_
tocollector application
.
For more information about supported configurations, see Integration recommendations.
Set Dashboard access
You must set the dashboard property value (if its existing value is null) when you add the Merchant configuration to an account. You must also set the dashboard
value (if its existing value is null) when you request the stripe_transfers feature for the Recipient configuration on an account. Choose from the following values:
express
: The connected account can access the Stripe Express Dashboard, which offers limited functionality. You can customize its appearance with your platform’s branding.full
: The connected account can access the full Stripe Dashboard. The full Stripe Dashboard lets your connected accounts view and manage their finances and reports.none
: The connected account can’t access either Stripe Dashboard. Your platform must provide all Stripe-related functionality.
Regardless of the dashboard
setting, your platform can use Connect embedded components to provide your connected accounts with similar functionality in a custom interface.
Dashboards are subject to the following restrictions:
- If you set
dashboard
toexpress
, then you must also set bothlosses_
andcollector fees_
tocollector application
. - If you set
dashboard
tofull
, then you must also set bothlosses_
andcollector fees_
tocollector stripe
.
For more information about supported configurations, see Integration recommendations.
Collect Know Your Customer (KYC) requirements 
Responsibility for collecting KYC requirements is based on the defaults.
and dashboard
values. In most configurations, Stripe is responsible for collecting KYC requirements from your connected accounts. Your platform is responsible only when you set defaults.
to application
and dashboard
to none
.
Note
Configure platform responsibility for requirements collection only if you’re prepared to manage the operational complexity required to verify requirement information and maintain compliance with any requirement updates.
Accounts v1 controller property map 
The settings described in this document correspond to Accounts v1 controller properties as follows:
Accounts v1 Property | Accounts v2 Property | Description |
---|---|---|
controller.fees.payer | defaults.responsibilities.fees_collector | Defines who collects payment fees for direct charges on the connected account. (For destination charges, Stripe always collects fees from your platform.) |
controller.losses.payments | defaults.responsibilities.losses_collector | Defines responsibility for negative balances incurred by the connected account. |
controller.requirement_collection | N/A | In Accounts v2, this responsibility is calculated based on the losses_ and dashboard values. |
controller.stripe_dashboard.type | dashboard | Specifies connected account access to Stripe Dashboards. |