Why a Stripe Connect Account Country Is Already Set During Onboarding

· 2 min read

A connected merchant may reach Stripe-hosted onboarding and find there is no option to choose a country. Stripe documents that specifying the account country or requesting a capability when creating the account prevents the account owner from changing its country in that flow. Where neither has been supplied, the choices available to the merchant depend on the account's dashboard and who collects the requirements.

Find out who set the country

Review the inputs your platform used to create the account alongside the current country on the Account object. Check whether a capability was requested during creation. If the platform supplied either of those settings, use the original inputs to explain why the country is already fixed. If neither was set, read the conditions in the hosted onboarding documentation for the dashboard configuration.

Setup Country decision Evidence to review
Account country supplied Owner cannot change it in that onboarding flow Creation parameters and country on the account
Capabilities requested at creation Country cannot be changed by the owner in the flow Requested capabilities and creation record
Eligible Express onboarding with country selection Available countries follow the platform configuration The countries enabled in onboarding options

Example with a merchant who expected to pick a country

A merchant tells the platform that its business should be onboarded in a different country from the one shown. The platform initially requested a capability as part of creating the account. Inspect the creation settings before assuming there is a missing field in the merchant interface. Confirm which business is being onboarded and its supporting records, then use the supported process for that account configuration.

Update the onboarding checklist

Collect the country information needed to set up the right connected account before redirecting the merchant. Compare the account country with the business information the platform holds and the applicable eligibility rules. Record who made the decision and why. This helps later reviews distinguish a completed country decision from a form field that the account owner is genuinely allowed to choose.

Official sources

  1. Stripe-hosted onboarding
  2. The Account object
  3. Identity verification for connected accounts