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_
orfee transfer_
parameter on a payment, they take precedence over the no-code pricing schemes. To apply the configured pricing, stop passing in these parameters.data[amount]
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
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:
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.