Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
Get started with Connect
Integration fundamentals
    Make API calls for connected accounts
    Integration recommendations
    Listen for updates
    Testing
    Accounts v2 API overview
Example integrations
Onboard accounts
Configure account Dashboards
Accept payments
Pay out to accounts
Manage your Connect platform
Tax forms for your Connect platform
Work with connected account types
HomePlatforms and marketplacesIntegration fundamentals

Recommended Connect integrations and charge types

Learn about the implications of Connect configuration options for different charge types and connected accounts.

Copy page

This document describes some of the Connect configuration options and their relationships, including the implications of using different types of charges. We recommend that you read it after learning about Connect’s essential features, but before designing your integration.

Recommended configurations

The following table shows some of Stripe’s recommendations for settings to use with each charge type. The rest of this document provides additional detail and reasoning.

OptionDirect ChargesDestination/Separate Charges
Dashboard
  • Full
  • Custom/Embedded
  • Full
  • Custom/Embedded
  • Express
Negative Balance Liability
  • Stripe
  • Platform
Payment fee collector
  • Platform
  • Stripe
  • Platform

Configurations for direct charges

Direct charges are transactions between your connected accounts and their customers. They usually involve the transfer of funds from the connected account to your platform.

For integrations using direct charges, we recommend assigning responsibility for connected account negative balances to Stripe. Direct charges involve greater risk of negative balances on connected accounts, because associated refunds directly reduce their balances. When a connected account has a negative balance and your platform is responsible, Stripe holds a reserve amount on your platform’s available balance.

We also recommend allowing access to the full Stripe Dashboard or a custom interface using embedded components, not the Stripe Express Dashboard, for the following reasons:

  • Connected accounts can’t define their own Radar rules using the Express Dashboard. Also, your platform Radar rules don’t apply to direct charges made on your connected accounts. To configure Radar rules for a connected account, your platform must set them up using the View Dashboard as this account feature.
  • When connected accounts use the Express Dashboard, your platform is always responsible for their negative balances.

For similar reasons, we don’t recommend using direct charges with Express connected accounts. In addition to the issues with using the Express Dashboard, the fee behavior for direct charges on Express accounts varies between Stripe features. That complicates your monetization strategy decisions.

Configurations for destination charges or separate charges and transfers

Destination charges and separate charges and transfers are transactions between your platform and customers of your connected accounts. They usually involve the transfer of funds from your platform to the connected account, but the connected account doesn’t charge the customer directly. Therefore, certain connected account settings don’t apply to these types of charges.

Avoid the following configurations in integrations that use destination charges or separate charges and transfers:

  • Don’t assign Stripe liability for negative balances on connected accounts. Because these charges occur on the platform, the platform is responsible for related negative balances.
    • Stripe always applies negative transactions, such as refunds and disputes, to the account where the associated charge was made. So any negative amount associated with a charge on the platform reduces the platform’s balance. The platform is always responsible for its own negative balances.
    • When your platform is liable for negative balances on connected accounts, you have more flexibility in moving funds between accounts. For example, a marketplace can accept a customer payment for items from multiple sellers, then transfer appropriate portions of the payment to the individual seller accounts.
    • In the case of refunds or disputes related to charges made on the platform, your platform can’t easily recover those funds from connected accounts.
  • Don’t have Stripe bill payment fees directly to connected accounts. Because these charges are created on the platform, Stripe takes the associated payment fees directly from the platform. If you configure Stripe to bill payment fees directly to connected accounts, it applies only to direct charges created on connected accounts.
  • Don’t allow connected accounts to configure their own Radar rules. Rules configured for a connected account don’t apply to charges created on the platform.

Connected account types

Legacy connected account types (Standard, Express, and Custom) support limited configurations and can have complex fee behaviors. We recommend that you instead define your connected accounts using controller properties.

If you already use legacy connected account types, we recommend that you replace them with controller property-based accounts.

Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc