{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"id":"stripe/connect-platform","name":"Stripe Connect platform setup","vendor":"Stripe","status":"researched","last_verified":null,"last_researched":"2026-10-25","summary":"Turn an activated Stripe account into a Connect platform (marketplace or SaaS): register the platform, complete the platform profile questionnaire and responsibilities, set branding, then onboard connected accounts through Stripe-hosted or embedded onboarding.","account_model":{"summary":"The platform's own Stripe account (activated with business details) gains a Connect application. Each seller or customer of the platform becomes a connected account under it; who pays fees, who covers losses and who collects KYC is set per connected account.","accounts":[{"name":"Platform Stripe account","kind":"organisation","owned_by":"the platform's business","required":true,"note":"Must be activated (business details verified) before live connected accounts can be created."},{"name":"Connect application","kind":"project","parent":"Platform Stripe account","required":true,"note":"Created when you register the platform; lets the platform create and act on connected accounts with its own API keys."},{"name":"Connected accounts","kind":"other","parent":"Connect application","required":true,"note":"One per seller/user. Dashboard access (full, Express or none) is fixed at creation; fees_collector and losses_collector (Accounts v2) or controller properties (v1) decide responsibilities."}],"notes":["Connected accounts onboarded in a sandbox or test mode are test-only and do not carry over to live mode (people report; see sharetribe-errors).","Countries where you can have connected accounts depend on the platform's own country."]},"prerequisites":[{"need":"An activated Stripe account for the platform business","note":"Covered by the stripe/account-and-billing entry where present; Stripe returns \"Your account must be activated in order to create accounts\" otherwise."}],"identity_requires":[],"have_ready":[{"kind":"company_documents","description":"Legal details of the platform business (name, registration, address, representative, beneficial owners)","why":"Needed to activate the platform's own Stripe account before going live.","needed_for":["activate-platform"],"auto_check":"name_consistency","source_url":"https://docs.stripe.com/connect/end-to-end-saas-platform.md?platform=web"},{"kind":"bank_account","description":"Bank account for the platform's payouts and any reserves","why":null,"needed_for":["activate-platform"],"auto_check":"none","source_url":"https://docs.stripe.com/connect/risk-management"},{"kind":"live_website","description":"Public website describing the platform, what sellers sell, and support contacts","why":"The platform profile asks about your business model and industry; Stripe screens for prohibited businesses.","needed_for":["platform-profile"],"auto_check":"website_live","source_url":"https://docs.stripe.com/connect/risk-management"},{"kind":"app_icon","description":"Platform brand name, square icon and brand colour","why":"Stripe-hosted onboarding requires brand name, colour and icon in Connect settings.","needed_for":["branding"],"auto_check":"none","source_url":"https://docs.stripe.com/connect/hosted-onboarding"},{"kind":"other","description":"Decisions on charge type (direct vs destination/separate), dashboard type for sellers, and who covers losses and collects KYC","why":"These set the platform's liability and are hard or impossible to change later (dashboard type is immutable).","needed_for":["platform-profile"],"auto_check":"none","source_url":"https://docs.stripe.com/connect/risk-management"}],"steps":[{"id":"register-platform","title":"Register your platform for Connect","summary":"In the Stripe Dashboard, open Connect and start platform onboarding, choosing marketplace or SaaS style. Signed-in human only.","route":"guided","gate":"human_login","human_only":true,"gate_label":"You sign in","depends_on":[],"optional":false,"url":"https://dashboard.stripe.com/connect","lead_time":null,"preflight":[],"captures":null},{"id":"activate-platform","title":"Verify and add business details (activate the platform account)","summary":"Complete the business activation form for the platform's own Stripe account. You submit identity and business details yourself; verapli never uploads documents or enters bank details.","route":"guided","gate":"human_identity","human_only":true,"gate_label":"You prove your identity","depends_on":["register-platform"],"optional":false,"url":"https://dashboard.stripe.com/account/onboarding","lead_time":null,"preflight":[],"captures":null},{"id":"platform-profile","title":"Complete the platform profile and acknowledge responsibilities","summary":"Answer the platform profile questionnaire (industry, business model, statement descriptor and dispute handling) and acknowledge your responsibilities for managing losses and collecting requirements. The person submits it.","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["activate-platform"],"optional":false,"url":"https://dashboard.stripe.com/connect/settings/profile","lead_time":{"official":null,"reported":{"text":"A third-party platform guide says Stripe aims to review platform profiles within one business day and may ask follow-up questions by email; Stripe does not publish a review time. [to verify]","source_url":"https://www.sharetribe.com/help/en/articles/9453619-troubleshoot-stripe-errors","source_title":"Troubleshoot Stripe errors (Sharetribe Help Center)"},"typical_minutes":null},"preflight":[],"captures":null},{"id":"branding","title":"Set Connect branding","summary":"Add the business name, icon and brand colour used on Stripe-hosted onboarding and the Express Dashboard.","route":"copilot","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["register-platform"],"optional":false,"url":"https://dashboard.stripe.com/settings/connect/stripe-dashboard/branding","lead_time":null,"preflight":[],"captures":null},{"id":"onboarding-options","title":"Configure onboarding options","summary":"Choose countries and default capabilities for Express accounts, optional public details to collect, and bank account collection during onboarding.","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["platform-profile"],"optional":true,"url":"https://dashboard.stripe.com/settings/connect/onboarding-options/countries","lead_time":null,"preflight":[],"captures":null},{"id":"build-onboarding","title":"Integrate connected-account onboarding","summary":"Create connected accounts and send each one through Stripe-hosted onboarding (Account Links) or the embedded account-onboarding component, then listen for requirement updates. Done in code with the platform's secret key.","route":"api","gate":"none","human_only":false,"gate_label":null,"depends_on":["platform-profile","branding"],"optional":false,"url":null,"lead_time":null,"preflight":[],"captures":null},{"id":"webhook-secret","title":"Create a Connect webhook endpoint","summary":"Add an event destination that listens to events from connected accounts (account.updated or v2 requirement events) and copy its signing secret.","route":"copilot","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["platform-profile"],"optional":false,"url":"https://dashboard.stripe.com/webhooks","lead_time":null,"preflight":[],"captures":"STRIPE_CONNECT_WEBHOOK_SECRET"}],"gates":[{"step":"register-platform","gate":"human_login","label":"You sign in"},{"step":"activate-platform","gate":"human_identity","label":"You prove your identity"},{"step":"platform-profile","gate":"human_submit","label":"You press submit"},{"step":"branding","gate":"human_submit","label":"You press submit"},{"step":"onboarding-options","gate":"human_submit","label":"You press submit"},{"step":"webhook-secret","gate":"human_submit","label":"You press submit"}],"lead_times":[{"step":"platform-profile","what":"Complete the platform profile and acknowledge responsibilities","official":null,"reported":{"text":"A third-party platform guide says Stripe aims to review platform profiles within one business day and may ask follow-up questions by email; Stripe does not publish a review time. [to verify]","source_url":"https://www.sharetribe.com/help/en/articles/9453619-troubleshoot-stripe-errors","source_title":"Troubleshoot Stripe errors (Sharetribe Help Center)"}}],"outputs":[{"name":"STRIPE_CONNECT_WEBHOOK_SECRET","description":"Signing secret of the webhook endpoint that receives connected-account events","secret":true,"example_format":"whsec_…","environments":null}],"renewals":[],"estimated_minutes":null,"guide_url":"https://verapli.com/guides/stripe/connect-platform"}