Fee behaviour on connected accounts

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

Selecting billing behaviour

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

The following sections describe the behaviour 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 such as 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 monetise 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 behaviours for direct charges and connected account usage of Stripe products matches the historical behaviour of Custom and Express accounts. For complete details, see the table below.

We recommend that you monetise 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 behaviours for payer values