When to Use an Onboarding Link or an Update Link in Stripe Connect

· 2 min read

A Stripe connected account can need further information after day-one onboarding. It can also need to update information the merchant previously provided. The hosted onboarding documentation distinguishes the link that collects outstanding requirements from the link that allows an eligible account to edit existing information. Before generating a link, identify which task the merchant actually needs and check the account's dashboard and requirement-collection configuration.

Choose the link for the task

The onboarding link collects information that is still outstanding. It can be useful for a new account or for an existing account whose added capability brings new requirements. The update link can let certain accounts revise previously provided information. Stripe restricts it to accounts where the platform collects requirements, including Custom accounts, and excludes accounts with access to a Stripe-hosted Dashboard. Some account configurations use embedded components for updates instead.

Merchant request Start here Confirm before showing the action
New account needs its first requirements collected Onboarding link Connected account ID and intended capabilities
Existing account has fresh requirements Onboarding link Which capability or review created the outstanding request
Merchant needs to edit earlier details Update link if eligible Dashboard access and who collects requirements

Example when the platform requests a new capability

A marketplace adds a capability for a current connected merchant. The earlier onboarding task may be complete, but the new capability can require another business detail. Generate the onboarding link for collecting the outstanding request. In contrast, if the merchant contacts you to update a detail already on file, check its account configuration before offering the update action. The two flows should remain distinct in the merchant interface.

Confirm what changed after the merchant acts

Use the current account data and the account update event to check whether the new requirement was supplied or the recorded information changed. Keep the status paired with the same connected account. If a configuration cannot use the update link, route the merchant through the appropriate experience for that account rather than repeatedly creating a link that does not support the requested change.

Official sources

  1. Stripe-hosted onboarding
  2. The Account object