| [ Web Proxy ] |
| Viewing: https://docs.stripe.com/connect/charges | [Back] [Original] |
In a Connect integration, for your platform or a connected account to accept a payment from a customer, you must first create a charge. The type of charge you create determines how the funds are distributed between your platform, the connected account, and Stripe. It also determines whether your platforms or the connected accounts information appears on the customers bank or billing statement and which account Stripe debits for refunds and chargebacks.
Connect uses three types of charges in two general categories:
The following table describes many factors to consider when choosing which charge type to use. Your platforms business model is particularly important because it can affect how funds flow through Stripe. To review Stripes recommendations for your business, refer to your platform profile.
| Charge type | Use cases | Examples |
|---|---|---|
| Direct charges |
|
|
| Destination charges |
|
|
| Separate charges and transfers |
|
|
You can use multiple charge types, if thats appropriate for your business.
Create a charge directly on a connected account. The accounts customers are often unaware of your platforms existence. You can specify an application fee, which transfers to your platforms account balance when the connected account collects the payment.
Your connected accounts must have the card_payments capability active in order to use direct charges.
This charge type is best suited for platforms providing Software as a Service (SaaS). For example, Shopify provides tools for building online storefronts, and Thinkific enables educators to sell online courses.
With this charge type:
For more information about direct charges, see Direct charges.
Create a charge on the platform and immediately transfer funds to the connected account. You decide whether some or all of those funds are transferred, and whether to deduct an application fee.
This charge type is best suited for marketplaces, such as a home rental marketplace or a ridesharing app.
With this charge type:
on_behalf_of.Funds flow for destination charges with the platform fee deducted from the transferred amount
Funds flow for destination charges with the platform fee paid after transferring the full amount
Destination charges support cross-region funds flows between platforms and connected accounts only in certain regions. For other regions, the platform and connected account must be in the same region unless using on_behalf_of. For more information about cross-region support, see Cross-border payouts.
For more information about destination charges, see Destination charges.
Create charges on your platform and split funds between multiple connected accounts, or hold them when you dont know the specific user at the time of the charge. The charge on your platform account is decoupled from the transfers to your connected accounts.
This charge type is best suited for marketplaces that need to split payments between multiple parties, such as DoorDash, a restaurant delivery platform.
With this charge type:
on_behalf_of.Separate charges and transfers require a more complex Connect integration. Use them only if your business use case requires them:
In some cases, the transfer amount can be greater than the charge amount, or the transfer is made before the payment is processed. You must monitor your account balance carefully to make sure it has enough available funds to cover the transfer amount. You can also associate a transfer with a charge so the transfer doesnt occur until the funds from that charge are available.
Funds flow for separate charges and transfers with multiple connected accounts
Separate charges and transfers support cross-region funds flows between platforms and connected accounts only in certain regions. For other regions, the platform and connected account must be in the same region unless using on_behalf_of. For more information about cross-region support, see Cross-border payouts.
For more information about separate charges and transfers, see Separate charges and transfers.
To make the connected account the business of record for the payment, use the on_behalf_of parameter. When on_behalf_of is set to the ID of the connected account, Stripe automatically:
delays_days setting.There are two components to Stripe fees with Connect: which pricing plan applies to the payment and which account pays Stripe fees.
When using Direct charges, you can choose how Stripe fees are billed to your connected accounts.
Read more about fee billing behaviors with Direct charges.
Destination charges and separate charges and transfers typically use the platforms pricing plan and are assessed on the platform. When the on_behalf_of field is set, the country of the connected account is used to determine the country specific fees charged to your platform account.
For more information on Connect fees and how to request custom pricing, see the Connect pricing page.
You can issue a refund to pay a customer back for money spent on a returned good or to compensate for unsatisfactory service. Stripe handles refunds differently for each of the charge types:
| Charge Types | Pending Refunds |
|---|---|
Direct charges | Stripe debits the refund amount from the connected accounts balance directly when you create a refund. If the connected accounts balance is insufficient, we set the refund status to |
Destination charges | Stripe debits your platform balance for the refund amount. You can reverse the transfers made to your connected accounts to recover your refund cost. If your platforms account balance doesnt have the funds when you issue the Refund, we set the refund status to If the refund request also attempts a transfer reversal, but the connected account has an insufficient balance, the refund request returns an error instead of creating a refund with |
Separate charges and transfers | Stripe debits your platform balance for the refund amount. You can reverse the transfers made to your connected accounts to recover your refund cost. If your platforms account balance doesnt have the funds when you issue the Refund, we set the refund status to |
For disputes on payments created using direct charges, Stripe debits the disputed amount from the connected accounts balance, not your platforms balance. Stripe can bill the dispute fee to either the platform or the connected account, depending on the connected accounts configuration. For more detail about how we bill fees for disputes on direct charges, see Fee behavior on connected accounts.
For disputes where payments were created on your platform using destination charges or separate charges and transfers, with or without on_behalf_of, your platform balance is automatically debited for the disputed amount and fee. When this happens, your platform can attempt to recover funds from the connected account by reversing the transfer either through the Dashboard or using the API.
If theres a negative balance on the connected account, Stripe attempts to debit the external account on file for the connected account only if debit_negative_balances is set to true.
If youre using Express or Custom legacy account types, your platform is responsible for disputes and fraud. For more details, see Disputes and fraud and Dispute categories, and follow Best practices for risk management. You can also use Fraud Stripe Apps to automate dispute management and handle chargebacks.
For most payment methods, you can control which ones your connected accounts accept. (Some payment methods can only be enabled by the account owner.) If you use dynamic payment methods, you can configure one or more payment method configurations for your connected accounts that use either direct charges or indirect charges with on_behalf_of. Connected accounts using indirect charges without on_behalf_of use the payment method configurations that you set up for charges on your platform.
For more information, see Manage payment methods for connected accounts.
| Web Proxy Viewer | New URL | Original Page |