Get risk-related requirements for Connected Accounts via API

Previously, the accounts to review page of the Dashboard was the only place to see your connected accounts with outstanding risk issues.

Now you’ll have consistent insight into risk-related requirements associated with your connected accounts via webhook events in the Accounts API. You can listen for and programmatically manage all compliance and risk-related requirements via the API, including terms of service requests and pending account closures. See the API docs for more details.

Opt in under Settings > Beta (Preview) features. Updated API responses will be rolled out to all platforms on November 12, 2024.

What does this change mean for you?

You’ll need to ensure that any notifications you send to your customers (email, push) triggered by account.updated webhook events for new risk requirements direct your connected account to the appropriate Stripe UI or component to resolve. You can continue to remediate compliance requirements via API response.

For new risk requirements, utilize one of the remediation paths below:

Connect embedded components: Embed Connect components directly into your website. When a requirement surfaces, direct your users to the account onboarding embedded component, where they’re prompted to complete any outstanding requirements directly in your UI. Alternatively, use the Notification banner embedded component to prompt your users.

Stripe hosted onboarding: Generate links to direct your connected accounts to complete outstanding requirements on the Stripe hosted onboarding page. You can programmatically generate Account Links or manually generate links to hosted onboarding from the Dashboard.

Complete on behalf of your accounts: You can use the Dashboard to identify and complete form-based risk requirements on behalf of your accounts from the connected account's details page.

We recommend you review any automated actions triggered by the account.updated webhook, and, if necessary, prepare your support teams in case your users have questions about the changes.

How can I access the new API features?

Opt in to receive risk-related webhooks in the Accounts API under Settings > Beta (Preview) features.

image2.png

image (10).png