Using Connect with Express accounts
Express enables your platform to manage payout schedules, customize the flow of funds, and control branding. Stripe will handle onboarding, account management, and identity verification for your platform.
With Express accounts, you can quickly onboard users so they can be paid immediately. You can customize the branding of the Express onboarding flow and dashboard. Stripe hosts the dashboard—you can grant access through your platform so your users can access it.
Get started
If you’re new to Connect, start with one of our guides to use Express accounts with your application:
- Collect payments and then pay out, if you’ll process payments with Stripe
- Pay out money, if you’ll add money from a bank account to pay out
Express demo
To see the complete Express onboarding flow in action, Stripe recommends trying our sample end-to-end Express integration before you start building your own. This demo includes an example of a user onboarding experience and account management for Rocket Rides, an on-demand marketplace.
You can find the demo’s complete source code on GitHub.

Prerequisites for using Express
To create Express accounts, you must meet all of these requirements:
- Minimum API version: Express requires the API version 2017-05-25 or later. Capabilities in Express require the API version 2019-02-19 or later.
- Platform in a supported country: Platforms in Australia, Austria, Belgium, Brazil, Bulgaria, Canada, Cyprus, the Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hong Kong, Hungary, India, Ireland, Italy, Japan, Latvia, Lithuania, Luxembourg, Malta, Mexico, the Netherlands, New Zealand, Norway, Poland, Portugal, Romania, Singapore, Slovakia, Slovenia, Spain, Sweden, Switzerland, the United Kingdom, and the United States can create Express accounts for any country Stripe supports.
- Vetting for fraud: Your platform is ultimately responsible for losses incurred by Express accounts. To best protect against this, you need to closely examine all accounts that sign up using your platform for potential fraud. Refer to our best practices guide for more information.
- Platform profile: You need to complete your platform’s profile.
Onboarding Express Accounts outside of your platform’s country
You can enable onboarding on a per-country basis in the Connect Settings section of your dashboard.
The Express account onboarding flow is currently localized in English, Spanish, French, German, Italian, Japanese, Simplified Chinese, Traditional Chinese, Danish, Finnish, Norwegian, Portuguese, Swedish, and Polish.
Keep the following in mind when onboarding accounts globally:
- International business: Your platform is responsible for understanding the implications of doing business internationally, such as tax and financial reporting.
- Charge flows: Be sure to review your options for creating charges based on the countries you intend to operate in.
- Service agreement type: Your platform can create connected accounts under the recipient service agreement to enable cross-border transfers. Such accounts have restricted access to capabilities.
How to use Connect Onboarding for Express accounts
-
Go to your Connect settings page to customize the visual appearance of the form with your brand’s name, color, and icon. Connect Onboarding requires this information.
-
Use the
/v1/accounts
API to create a new account and get the account ID. You can prefill information on the account object for the user before you generate the account link. You must pass the following parameter: -type
=express
-
Call the Account Links API with the following parameters. For more parameters, see the API ref. -
account
-refresh_url
-return_url
-type
=account_onboarding
-
In the onboarding flow for your own platform, redirect your user to the
url
returned by Account Links. -
Handle additional account states, redirecting your user to the Connect Onboarding flow if necessary.
Step 1: Create an Express account and prefill information
Use the /v1/accounts
API to create an Express account and set type
to express
in the account creation request.
curl https://api.stripe.com/v1/accounts \ -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \ -d type=express
# Set your secret key. Remember to switch to your live secret key in production! # See your keys here: https://dashboard.stripe.com/account/apikeys Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc' account = Stripe::Account.create({ type: 'express', })
# Set your secret key. Remember to switch to your live secret key in production! # See your keys here: https://dashboard.stripe.com/account/apikeys stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc' account = stripe.Account.create( type='express', )
// Set your secret key. Remember to switch to your live secret key in production! // See your keys here: https://dashboard.stripe.com/account/apikeys \Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc'); $account = \Stripe\Account::create([ 'country' => 'US', 'type' => 'express', ]);
// Set your secret key. Remember to switch to your live secret key in production! // See your keys here: https://dashboard.stripe.com/account/apikeys Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"; AccountCreateParams params = AccountCreateParams.builder() .setType(AccountCreateParams.Type.EXPRESS) .build(); Account account = Account.create(params);
// Set your secret key. Remember to switch to your live secret key in production! // See your keys here: https://dashboard.stripe.com/account/apikeys const Stripe = require('stripe'); const stripe = Stripe('sk_test_4eC39HqLyjWDarjtT1zdp7dc'); const account = await stripe.accounts.create({ type: 'express', });
// Set your secret key. Remember to switch to your live secret key in production! // See your keys here: https://dashboard.stripe.com/account/apikeys stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc" params := &stripe.AccountParams{ Type: stripe.String(string(stripe.AccountTypeExpress)), } acct, _ := account.New(params)
// Set your secret key. Remember to switch to your live secret key in production! // See your keys here: https://dashboard.stripe.com/account/apikeys StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"; var options = new AccountCreateOptions { Type = "express", }; var service = new AccountService(); var account = service.Create(options);
If you know the country and capabilities for your connected account, you can provide that information when you create the account. Connect Onboarding then collects the requirements for those capabilities.
curl https://api.stripe.com/v1/accounts \ -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \ -d country=US \ -d type=express \ -d "capabilities[card_payments][requested]"=true \ -d "capabilities[transfers][requested]"=true
# Set your secret key. Remember to switch to your live secret key in production! # See your keys here: https://dashboard.stripe.com/account/apikeys Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc' account = Stripe::Account.create({ country: 'US', type: 'express', capabilities: { card_payments: { 'requested': true, }, transfers: { 'requested': true, }, }, })
# Set your secret key. Remember to switch to your live secret key in production! # See your keys here: https://dashboard.stripe.com/account/apikeys stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc' account = stripe.Account.create( country='US', type='express', capabilities={ 'card_payments': { 'requested': True, }, 'transfers': { 'requested': True, }, }, )
// Set your secret key. Remember to switch to your live secret key in production! // See your keys here: https://dashboard.stripe.com/account/apikeys \Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc'); $account = \Stripe\Account::create([ 'country' => 'US', 'type' => 'express', 'capabilities' => [ 'card_payments' => [ 'requested' => true, ], 'transfers' => [ 'requested' => true, ], ], ]);
// Set your secret key. Remember to switch to your live secret key in production! // See your keys here: https://dashboard.stripe.com/account/apikeys Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"; AccountCreateParams params = AccountCreateParams.builder() .setCountry("US") .setType(AccountCreateParams.Type.EXPRESS) .setCapabilities( AccountCreateParams.Capabilities.builder() .setCardPayments( AccountCreateParams.Capabilities.CardPayments.builder() .setRequested(true) .build()) .setTransfers( AccountCreateParams.Capabilities.Transfers.builder() .setRequested(true) .build()) .build()) .build(); Account account = Account.create(params);
// Set your secret key. Remember to switch to your live secret key in production! // See your keys here: https://dashboard.stripe.com/account/apikeys const Stripe = require('stripe'); const stripe = Stripe('sk_test_4eC39HqLyjWDarjtT1zdp7dc'); const account = await stripe.accounts.create({ country: 'US', type: 'express', capabilities: { card_payments: { requested: true, }, transfers: { requested: true, }, }, });
// Set your secret key. Remember to switch to your live secret key in production! // See your keys here: https://dashboard.stripe.com/account/apikeys stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc" params := &stripe.AccountParams{ Type: stripe.String(string(stripe.AccountTypeExpress)), Country: stripe.String("US"), Capabilities: &stripe.AccountCapabilitiesParams{ CardPayments: &stripe.AccountCapabilitiesCardPaymentsParams{ Requested: stripe.Bool(true), }, Transfers: &stripe.AccountCapabilitiesTransfersParams{ Requested: stripe.Bool(true), }, }, } acct, _ := account.New(params)
// Set your secret key. Remember to switch to your live secret key in production! // See your keys here: https://dashboard.stripe.com/account/apikeys StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"; var options = new AccountCreateOptions { Type = "express", Country = "US", Capabilities = new AccountCapabilitiesOptions { CardPayments = new AccountCapabilitiesCardPaymentsOptions { Requested = true, }, Transfers = new AccountCapabilitiesTransfersOptions { Requested = true, }, }, }; var service = new AccountService(); var account = service.Create(options);
If you omit capabilities
, Connect Onboarding uses the settings in the Configuration settings section of the Stripe Dashboard to automatically request capabilities based on the country for the connected account.
If you’ve already collected information for your connected accounts, you can prefill that information on the account object for the user and it won’t be collected again in the Connect Onboarding flow. Connect Onboarding only collects required information when you create or update an account.
Step 2: Create an account link
You can create an account link by calling the Account Links API with the following parameters:
account
refresh_url
return_url
type
=account_onboarding
curl https://api.stripe.com/v1/account_links \ -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \ -d account=acct_1032D82eZvKYlo2C \ -d refresh_url="https://example.com/reauth" \ -d return_url="https://example.com/return" \ -d type=account_onboarding
# Set your secret key. Remember to switch to your live secret key in production! # See your keys here: https://dashboard.stripe.com/account/apikeys Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc' account_links = Stripe::AccountLink.create({ account: 'acct_1032D82eZvKYlo2C', refresh_url: 'https://example.com/reauth', return_url: 'https://example.com/return', type: 'account_onboarding', })
# Set your secret key. Remember to switch to your live secret key in production! # See your keys here: https://dashboard.stripe.com/account/apikeys stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc' account_links = stripe.AccountLink.create( account='acct_1032D82eZvKYlo2C', refresh_url='https://example.com/reauth', return_url='https://example.com/return', type='account_onboarding', )
// Set your secret key. Remember to switch to your live secret key in production! // See your keys here: https://dashboard.stripe.com/account/apikeys \Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc'); $account_links = \Stripe\AccountLink::create([ 'account' => 'acct_1032D82eZvKYlo2C', 'refresh_url' => 'https://example.com/reauth', 'return_url' => 'https://example.com/return', 'type' => 'account_onboarding', ]);
// Set your secret key. Remember to switch to your live secret key in production! // See your keys here: https://dashboard.stripe.com/account/apikeys Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"; AccountLinkCreateParams params = AccountLinkCreateParams.builder() .setAccount("acct_1032D82eZvKYlo2C") .setRefreshUrl("https://example.com/reauth") .setReturnUrl("https://example.com/return") .setType("account_onboarding") .build(); AccountLink accountLink = AccountLink.create(params);
// Set your secret key. Remember to switch to your live secret key in production! // See your keys here: https://dashboard.stripe.com/account/apikeys const Stripe = require('stripe'); const stripe = Stripe('sk_test_4eC39HqLyjWDarjtT1zdp7dc'); const accountLinks = await stripe.accountLinks.create({ account: 'acct_1032D82eZvKYlo2C', refresh_url: 'https://example.com/reauth', return_url: 'https://example.com/return', type: 'account_onboarding', });
// Set your secret key. Remember to switch to your live secret key in production! // See your keys here: https://dashboard.stripe.com/account/apikeys stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc" params := &stripe.AccountLinkParams{ Account: stripe.String("acct_1032D82eZvKYlo2C"), RefreshURL: stripe.String("https://example.com/reauth"), ReturnURL: stripe.String("https://example.com/return"), Type: stripe.String("account_onboarding"), } acc, _ := accountlink.New(params)
// Set your secret key. Remember to switch to your live secret key in production! // See your keys here: https://dashboard.stripe.com/account/apikeys StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"; var options = new AccountLinkCreateOptions { Account = "acct_1032D82eZvKYlo2C", RefreshUrl = "https://example.com/reauth", ReturnUrl = "https://example.com/return", Type = "account_onboarding", }; var service = new AccountLinkService(); var accountLink = service.Create(options);
Step 3: Redirect your user to the account link URL
The response to your Account Links request includes a value for the key url
. Redirect to this link to send your user into the flow. URLs from the Account Links API are temporary and can only be used once because they grant access to the account holder’s personal information. Authenticate the user in your application before redirecting them to this URL. If you want to prefill information, you must do so before generating the account link. After you create the account link for an Express account, you won’t be able to read or write information for the account.
Step 4: Handle the user returning to your platform
Connect Onboarding requires you to pass both a return_url
and refresh_url
to handle all cases where the user will be redirected to your platform. It’s important that you implement these correctly to provide the best experience for your user.
return_url
Stripe issues a redirect to this URL when the user completes the Connect Onboarding flow. This doesn’t mean that all information has been collected or that there are no outstanding requirements on the account. This only means the flow was entered and exited properly.
No state is passed through this URL. After a user is redirected to your return_url
, check the state of the details_submitted
parameter on their account by doing either of the following:
- Listening to
account.updated
webhooks. - Calling the Accounts API and inspecting the returned object.
refresh_url
Your user will be redirected to the refresh_url
in these cases:
- The link is expired (a few minutes went by since the link was created).
- The link was already visited (the user refreshed the page or clicked back or forward in the browser).
- Your platform can no longer access the account.
- The account has been rejected.
Your refresh_url
should trigger a method on your server to call Account Links again with the same parameters, and redirect the user to the Connect Onboarding flow to create a seamless experience.
Step 5: Handle users that have not completed onboarding
A user that’s redirected to your return_url
might not have completed the onboarding process. Use the /v1/accounts
endpoint to retrieve the user’s account and check for charges_enabled
. If the account isn’t fully onboarded, provide UI prompts to allow the user to continue onboarding later. The user can complete their account activation through a new account link (generated by your integration). You can check the state of the details_submitted
parameter on their account to see if they’ve completed the onboarding process.