Platform pricing toolsBeta

Design personalized pricing strategies with our no-code UI tool designed for platforms.

Platform pricing tools enable you to store pricing logic within Stripe for monetization, reducing the effort needed to successfully integrate. As a beta feature, your platform needs to have permissions to access the platform pricing tools.

Platform pricing tools allow you to create pricing schemes that apply different application fees based on the properties of a transaction, without having to pass an application fee amount through the API. These pricing schemes apply to activity on your connected accounts where your platform is responsible for the Stripe fees.

Request an invite

Create a pricing scheme

A pricing scheme is a list of conditional fees that Stripe evaluates from top to bottom, with a default fee applied to any transactions that don’t match a defined condition exactly. A conditional fee is made up of a fee and a set of conditions. When a transaction occurs, Stripe applies the first matching conditional fee (from top to bottom). If no conditional fees match the transaction, Stripe uses the default fee.

Go to the Connect settings page in your Stripe Dashboard.
Click Platform pricing to go to your Platform pricing page.
Click Add rules to open the Set a default payment pricing scheme dialog.
Click Add pricing rule to create a new conditional fee rule. Use the dropdown menus to define the rule. Stripe calculates the fee in the specified currency, and then converts it to the settlement currency of the payment, if needed. You can add multiple pricing rules for the same pricing scheme, and they’re evaluated in the order that you select.
- Condition: Use the dropdown menus to define a condition that the rule applies to. The options available for the right input depend on the selection you make on the left dropdown. For more information about conditions on specific transactions, see Products.
- Fee type: Select Fixed, Variable, or Blended.
  - Fixed: Charge a specific amount. For example, charge 1.10 USD for every payment.
  - Variable: Charge a percentage of the total amount of the payment. For example, charge .45% of the total payment amount.
    - Minimum (optional): Specify a minimum for the fee amount. For example, charge at least 0.50 USD for every payment.
    - Maximum (optional): Specify a cap for the fee amount. For example, cap every fee at 2.00 USD.
  - Blended: Charge a specific amount on top of a percentage of the total payment. For example, charge 1.10 USD for every transaction in addition to .45% of the total payment amount.
    - Maximum (optional): Specify a cap for the fee amount. For example, cap every fee at 2.00 USD.
Under Set fallback rule, set a variable amount, fixed amount, or both. Use the Fixed dropdown to select the appropriate currency for the fixed amount. Stripe applies the default fee rule if any of the conditional fees you set aren’t matched by a particular transaction. The default fee must be a non-zero amount. You can’t have a zero percentage variable amount and a zero fixed amount.
(Optional) Click the Add modifier if you want to take the calculated application fee and either mark it up or discount it by a certain percentage.
Click Save. Alternatively, close the dialog without saving the conditions you created.
If you’re passing in an explicit application_fee or transfer_data[amount] parameter on a payment, they take precedence over the no-code pricing schemes. To apply the configured pricing, stop passing in these parameters.

When you save the pricing scheme, Stripe automatically copies the pricing scheme to all of your connected accounts. The time it takes to update all your accounts depends on the number of connected accounts on your platform. Stripe displays a notice with the progress update in the Connect settings page.

Override a specific account

After you set up a pricing scheme, you can override the rules for connected accounts that don’t have access to the full Stripe Dashboard (including Express and Custom accounts).

Select the account from the Connected accounts page in your Dashboard.
On the connected account details page, click Customize pricing in the Account pricing section for COLLECT APPLICATION FEES ON PAYMENTS to open the Customize pricing dialog. If an overridden pricing scheme already exists, click Edit to open the dialog and make changes.
If you’re creating a new override, Stripe provides the option to start a blank pricing scheme (Create a new scheme) or to copy the pricing scheme set at the platform level as a starting point (Copy from your platform’s pricing scheme). If you want to make small adjustments to a complex pricing scheme for your platform, click the Copy from your platform’s pricing scheme button. Otherwise, click Create new pricing to build a new pricing scheme from scratch.
Set the desired conditional and default fees as described in the preceding Create a pricing scheme section.
Click Save to save the override. Alternatively, close the dialog without saving. You’ll be prompted to Confirm the changes.

Subsequent edits to the platform pricing scheme don’t update the pricing scheme of overridden connected accounts.

Revert overridden pricing schemes

You can revert overridden pricing schemes on the account details page. Click Revert to platform pricing in the Account pricing section of a connected account details page to use the platform’s pricing scheme for the connected account.

Revert to platform pricing

Products

Pricing scheme application

Stripe applies pricing schemes to a payment when all of the following are true:

The pricing scheme is enabled.
Your platform is responsible for the Stripe fees on the payment.
The account is in a country that your platform is eligible to take application fees for.
The application_fee or transfer_data[amount] parameters aren’t present on the payment. An explicit application_fee or transfer_data[amount] always takes precedence over managed application fees.
The payment didn’t use multicapture
The amount used to calculate a fee is the captured amount of the payment. If the payment is a card charge authorized for 10 USD, and only 5 USD is captured, 5 USD is the amount used to compute the fee.

Conditions

Field	Applies to	Description
Payment method	All payments	The payment method used, for example `card`, `us_bank_account`, or `boleto`
Presentment currency	All payments	The currency that the customer paid in
Settlement merchant country	All payments	The country of the payment settlement merchant
Card brand	Card payments	The type of card used, for example Visa or Mastercard
Card present	Card payments	Whether or not the payment is in-person
Card country	Card payments	The country of the card that the customer paid with
Card product code	Card payments	The product code of the card that the customer paid with
Card type	Card payments	Funding source of the card, such as a credit card or debit card
Card product category	Card payments	Card class classification, such as a Standard or Premium card
Card border	Card payments	Whether the card used is a domestic or international card
Manually entered	Card payments	Whether card details are typed into and processed on the Stripe Dashboard
European Economic Area card charge	Card payments	Whether the charge is processed within the European Economic Area. This includes cards created within the United Kingdom.
UK card and European Economic Area seller	Card payments	Whether the seller is located within the European Economic Area and the card country is the United Kingdom.
Klarna payment category	Klarna payments	The Klarna payment category used on a Klarna payment
Klarna customer country	Klarna payments	The country of the customer making the Klarna payment
US Bank Account availability	US Bank Account payments	The settlement timing of the ACH Direct Debit payment

Fee modifier

A fee modifier can either be a discount or markup. A markup applies a percent increase on the fee amount, whereas a discount applies a percent decrease. These will be calculated on the fee amount determined by the conditional and fallback rules.

Modifiers will compound based on the order they were added. For example, a 5% discount followed by a 10% markup will adjust a $1.00 fee to a $1.05 fee ($1.00 x 0.95 x 1.1 = $1.05).

Interaction with subscriptions and invoices

Stripe applies managed application fees, configured in pricing tools, on invoice and subscription payments.

If you provide an application fee amount when creating an invoice, that fee takes precedence and Stripe doesn’t apply the configured managed application fee.

If you provide an application fee percent on a subscription, that fee takes precedence and Stripe doesn’t apply the configured managed application fee.

View collected fee details

The collected fees page is available by going to Payments and clicking Collected Fees. After selecting a fee from the list of collected fees, you’re provided with a detailed breakdown of how Stripe computed the application fee using the pricing scheme.

Platforms have access to the following information:

Matched rules: The pricing rules that computed the fee. The fee type is applied to the charge amount to generate the intermediary fee.
Additional markups applied: Shows the markups or discounts set by the platform. A variable fee from the markups is applied on the intermediary fee from step 1 above to generate the final fee.
Historical pricing scheme: This is a historical snapshot of the pricing scheme active at the time of fee computation.

The detailed breakdown section looks like the following:

Application fee breakdown showing selected rules.

Access platform pricing tools

Different roles have different levels of access to pricing schemes.

Although some roles don’t have access to the platform’s default pricing, they might be able understand it based on the version copied to the connected accounts.

Role	Permissions
Administrator	Read and write
Developer	None
IAM Admin	None
Connect Onboarding Analyst	None
Transfer Analyst	None
Analyst	None
Dispute Analyst	None
Refund Analyst	None
Support Specialist	None
Support Only	None
Tax Analyst	None
View Only	None
Topups Only	None