Create a connected account

Create and configure your connected accounts using the Accounts v2 API.

When you add a connected account to your SaaS platform, its configuration defines the interactions between it, your platform, and Stripe, including:

How payments get distributed to each party
Which business pays Stripe fees
Which business funds refunds and disputes

Before you begin

Follow the onboarding process to set up your Stripe platform account.

This guide describes the different elements of a connected account that uses your platform to process payments for its business. The code sample at the end of this guide shows the create connected account request that includes all the elements, but you can also use the update method to build the connected account properties iteratively.

Create a connected account

Define the connected account identity properties, such as its name, address, primary contact details, and business type. You can also let the account user provide these values during onboarding.

Assign configurations

Connected accounts interact with your platform and Stripe based on which configurations you assign. Most SaaS platforms assign:

The merchant configuration allows the connected account to accept card payments from its own customers.
The customer configuration allows the connected account to pay your platform a subscription fee, if you charge one.

Specify merchant capabilities

The merchant configuration governs how payments from the connected account’s customers behave in Stripe. When you assign this configuration, you must also specify the following parameters.

Setting	Behavior	Values
Dashboard	How the connected account views their Stripe activity and settings.	`express` `full` `none`
Fee collection	Determines who collects payment fees from the connected account.	`stripe` (Stripe collects fees directly) `application` (Your platform collects application fees, then Stripe collects fees from your platform)
Loss responsibility	Assigns responsibility for negative balances incurred by the connected account.	`stripe` (Stripe is liable for connected account negative balances) `application` (Your platform is liable for negative balances and manages risk for the connected account)
Payment method acceptance	Enable payment methods for the connected account to accept.	See the list of available payment method capabilities. You must minimally request `card_payments`.

Specify customer capabilities

The customer configuration defines how your connected account pays for their subscription to your platform, including whether you collect taxes from them and how you bill them.

Code sample

The following code sample shows a create connected account request that adds the merchant and customer configurations where:

Stripe collects fees and manages risk for direct payments to the connected account.
The connected account has card payments enabled.
The connected account can access their account through the Stripe Dashboard.
The include parameter requests full values in the response for specific parameter objects, which otherwise default to null.

Command Line

Select a language

cURL

Stripe CLI

Ruby

Python

PHP

Java

Node.js

.NET

No results

Next steps

After you create and configure your connected account, set up Dashboard access for them.