Fee behavior on connected accounts

The controller.fees.payer property on v1/accounts determines the set of billing behaviors you can expect for direct charges and product usages that occur on this connected account. This doc details the behavior of the different values it can have.

Selecting billing behavior

You can only set the controller.fees.payer property when you create an account.

The following sections describe the behavior of each value.

account

Stripe collects fees directly from your connected account. We don’t charge any Connect fees to it or to your platform.

Any application fees that your platform bills to the connected account are in addition to Stripe fees.

You can set the payer type to account when you create connected accounts. Accounts created with type=standard also have this value.

application

The platform pays payment fees for direct charges and fees for Stripe products like Radar, Card Account Updater, and Instant Payouts. For complete details, see the table below.

The platform also pays Connect fees for these accounts .

We recommend that you monetize payments and Stripe products where the platform is billed by collecting fees from your connected accounts.

You can set the payer type to application when you create connected accounts.

Platforms that pay Stripe payment fees for direct charges can access dedicated reports.

See Platform Reporting for direct charge payment fees paid by platform.

application_custom or application_express

application_custom and application_express are assigned to accounts created with type=custom and type=express, respectively. Their billing behaviors for direct charges and connected account usage of Stripe products matches the historical behavior of Custom and Express accounts. For complete details, see the table below.

We recommend that you monetize payments and Stripe products where the platform is billed by collecting fees from your connected accounts.

You can’t set the payer type to application_custom or application_express when you create connected accounts. They only apply to accounts created with type=custom or type=express.

List of fee behaviors for payer values

When connected accounts pay Stripe fees, they’re the same as fees paid by non-Connect Stripe users.