Account management
Show account details and allow them to be edited.
Account management renders a UI component for connected accounts to view and manage their account details. Connected accounts can view and edit account information such as personal or business information, public information, and bank accounts they use for payouts.
Requirements collection options
When a connected account has outstanding requirements, embedded account management prompts the connected account to update their information. You can control the collection of currently_
or eventually_
requirements, and whether to include future requirements, using the collectionOptions
attribute.
The details submitted attribute
The account management component renders only for accounts where the details_submitted attribute is true
. If an account hasn’t gone through onboarding, the account management component fails to render. In this scenario, we recommend using the account onboarding component.
Displayed fields
The fields that the account management component displays depend on how you configured the connected account—specifically on the connected account country, business type, capabilities and service agreement type. This works similarly to how the onboarding component only collects the information that’s required for how the connected account is configured.
External account collection
Use the external_account_collection feature to control whether the component collects external account information. This parameter is enabled by default, and only platforms responsible for collecting updated information when requirements are due or change (including Custom accounts) can disable it. When enabled, this option requires user authentication. You can opt out of Stripe user authentication with the disable_stripe_user_authentication parameter.
Disable Stripe user authentication
Use the disable_stripe_user_authentication feature to control whether the component requires Stripe user authentication. By default, this parameter is false when external_
is true and true otherwise. Only platforms responsible for collecting updated information when requirements are due or change (including Custom accounts) can disable Stripe authentication.
We recommend implementing 2FA or equivalent security measures as a best practice. For account configurations that support this feature, such as Custom accounts, you assume liability for connected accounts if they can’t pay back negative balances.
Create an Account Session
When creating an Account Session, enable account management by specifying account_
in the components
parameter.