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
Example integrations
Onboard accounts
Configure account Dashboards
Accept payments
Pay out to accounts
Manage your Connect platform
    Understand your Connect business
    Dashboard account management
    Remediation links
    Risk management with Connect
    Platform pricing tools
      Pricing schemes
      Pricing groups
      Complex conditions
      Testing
      Card product codes
Tax forms for your Connect platform
Work with connected account types
HomePlatforms and marketplacesManage your Connect platform

Platform pricing tools

Use your Dashboard editor to manage your application fee pricing logic.

Copy page

If your platform is responsible for paying Stripe fees, platform pricing tools allow you to define how you recoup your payment processing costs from your connected accounts through application fees.

  • Create pricing schemes that apply different application fees based on the properties of a transaction.
  • Define pricing groups to use different pricing schemes for different connected accounts.
Shows the Add pricing rule dialog in the Dashboard.

Eligibility for payments

The values available for defining your pricing scheme depend on which Stripe products you use and how you’ve integrated them. The following sections describe which platform configurations can use and access the platform pricing tools.

Requirements

Stripe applies pricing schemes to a payment when the payment meets all of the following requirements:

  • The pricing scheme is enabled.
  • Stripe charges fees on the payment to your platform rather than the connected account.
  • Your platform is permitted to charge app fees in the connected account’s country.
  • The payment doesn’t explicitly apply application_fee or transfer_data[amount] parameters that override managed application fees.
  • The payment doesn’t use multi-capture.

In addition to the requirements, pricing schemes observe the following limitations:

  • If you use Standard Connect with destination charges, you can’t override pricing or implement different pricing schemes for individual connected accounts.
  • If a payment’s captured amount is less than the charge, the calculated fee is against the captured amount of the payment. For example, if only 5 USD is captured on a 10 USD charge, the fee is based on 5 USD.

Fee payer reference

Support for platform pricing tools also depends on your funds flow configuration for your connected accounts.

  • Controller property configurations:
    • You can use platform pricing tools to calculate application fees for all accounts where the controller.fees.payer on the account is the Connect platform (application).
    • If a connected account uses destination charges, the platform is the fee payer even if you set controller.fees.payer=account.
  • Standard, Custom, or Express type configuration:
    • Configured pricing applies to destination charges.
    • Configured pricing doesn’t apply to direct charges unless the platform is on IC+ pricing.

Eligibility for Instant Payouts

Stripe applies pricing schemes to an Instant Payout when:

  • Your platform controls pricing.
  • Your pricing scheme is enabled.
  • Your connected accounts are eligible for Instant Payouts.
    • When Stripe is liable for connected account losses, Stripe determines connected account eligibility and volume limits. You must set up separate pricing rules for each Instant Payout currency for these connected accounts.
    • When your platform is liable for connected account losses, your platform manages eligibility for connected accounts. These connected accounts must be in the same country as the platform, so different currencies don’t apply.
    • A connected account must have an external account that supports Instant Payouts.

Connected accounts can’t pay out more than their available balance. Instant Payout fees reflect in the Payout object to help with reporting and reconciliation. See Transactions in the Dashboard to view your collected fees. If an Instant Payout fails, we automatically refund the application fee.

Instant payout application fees API integration impact

Enabling pricing tools for Instant Payouts without using the Balance API net-of-fees attribute can break your API integration.

Subscriptions and invoices

Stripe also applies your pricing scheme-defined application fees to invoice and subscription payments. As with standard purchase payments, when you apply an explicit application fee to an invoice or subscription, that fee overrides any matching scheme-defined fee.

Access platform pricing tools

Different roles have different levels of access to pricing schemes.

Roles that don’t have access to the platform’s default pricing can review the version copied to the connected accounts. Connected accounts can’t view or edit any pricing schemes.

The following roles can access pricing schemes that apply to all connected accounts.

RolePermissions
AdministratorRead and write
DeveloperNone
IAM AdminNone
Connect Onboarding AnalystNone
Transfer AnalystNone
AnalystNone
Dispute AnalystNone
Refund AnalystNone
Support SpecialistNone
Support CommunicationsNone
Tax AnalystNone
View OnlyNone
Top-ups SpecialistNone
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