Update Stripe Connect Onboarding article

[SariSaar]

No description provided.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
flex-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Oct 31, 2024 3:17pm

[shareoc]

We have this article: https://www.sharetribe.com/docs/how-to/save-payment-card
on how the template handles saved payment method. So maybe this section could be client agnostic

[shareoc]

Also we could mention what relevance setupIntents have in this process: https://www.sharetribe.com/api-reference/marketplace.html#create-stripe-setup-intents

[shareoc]

@SariSaar
I would adjust the article structure under the current Stripe for providers: Stripe Connect Onboarding heading. The current structure reads to me as a how-to (e.g., with steps 1-4).

Here’s a possible TOC and some ideas on what it could cover — just a suggestion to consider!

Provider onboarding in Stripe

• Why is onboarding required for Providers, why do we recommend using Stripe hosted onboarding

  Stripe Connect Onboarding Flow (subheading)

  • How does this flow work from a technical perspective (client agnostic) (e.g. we Fetch Stripe Token, create stripe account, create stripe account link).
  • Maybe links to Connect Onboarding components like StripePayoutPage and StripeConnectAccountForm

  Stripe Accounts (subheading)

  • What are stripe connect accounts and how does the StripeAccount endpoint correlate
  • What Sharetribe endpoint is used and what kind of calls do we make to Stripe
  • Current article states things like “it’s recommended for you to pass the following information in the create-stripe-account call” but doesn’t explain why. I think we should be more explicit on what info you should pass to the endpoint and why. A lot of the parameters are listed as optional in the API ref and it’s unclear why they are optional
  • What are Stripe Persons (https://www.sharetribe.com/api-reference/marketplace.html#create-stripe-person) and when are they used

  Handling Verification Status & Stripe Account links

  • Why does Stripe stagger requirements and how can the client know if the Stripe account needs more info
  • Modifying at which point Stripe asks for extra requirements (https://github.com/sharetribe/web-template/blob/main/src/ducks/stripeConnectAccount.duck.js#L287 e.g. modifying the currently_due parameter)
  • Maybe keep the examples from the template but we could also provide examples of what API responses correspond with each