Fees

A fee adds a charge to a product's price, such as a setup or admin fee. It's either a fixed amount or a percentage:

🚧

Percentage fees aren't supported yet

Only fixed-amount fees (amount_type) are supported right now. Don't create fees with value_type set to percentage_type.

Attach a fee to a product with product_fee_id. On a subscription, set fee_for_initial_payment_only to charge it on the first payment only.

A fixed fee is charged in the product's currency. Set apply_conversion_rate to true to convert it when an order uses another currency.

To stop using a fee, set is_active to false.

How a fee is charged

The fee is added after any discount. Tax is then taken out of the total, not added on top.

A percentage fee is taken from the line total (price × quantity) on an order, or from the price alone in a product preview.