Platform pricing tools

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.

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 the 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 configuration:
  • You can use platform pricing tools to calculate application fees for all charges 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.

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.