Connect margin reportsBeta
Compute your margins by analysing your Connect volume, revenue and costs.
The Connect margin reports show platforms their aggregated and transaction-level payment volumes, fees, and revenue associated with activity where the platform is responsible for pricing and fees. Use these reports to calculate your margins and set your fees appropriately given your underlying Stripe fees and network costs.
Platform support![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
These reports only support platforms that explicitly state an application fee on their charges, either directly in the API or through Platform Pricing Tools. They identify fees taken using application_
, but don’t identify fees taken using transfer_data.amount or account debits.
User access![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Users with the following user roles can access the Margin Reports:
- Administrator
- Analyst
- Data Migration Specialist
- Developer
- Tax Analyst
- View only
Margin report data![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Margin reports include charges based on the timestamp of the originating event, not the timestamp when a fee is assessed. For example, to view a fee assessed on 1 February for a charge created on 31 January, run the report for January.
A margin report includes data for the following types of charges:
- Connect direct charges where the platform collects application fees
- Destination charges where the platform collects application fees, with or without on_behalf_of
It does not include data for the following types of charges:
- Direct charges where the connected account is responsible for fees
- Direct charges on the platform (such as SaaS subscriptions they run on the same account)
- Separate charges and transfers
- Non-Connect direct charges on a connected account
Note
A margin report normalises all values to USD using the conversion rate at the time of activity. We plan to add other normalisation currencies in a future release.
Available margin reports![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Report type | Description | Usage |
---|---|---|
Summary | Platform-level aggregated view of Connect volume, revenue and fees | Calculate monthly margins for your platform |
Transaction | Transaction-level view of Connect volume, revenue and fees | Identify which transactions are driving margins up or down |
Connected Account (coming soon) | Connected account-level view of Connect volume, revenue and fees | Identify which connected accounts are driving margins up or down |
![Example of a summary margin report](https://b.stripecdn.com/docs-statics-srv/assets/summary-margin-report.4b348d78a47df2e2ab99328136a93cb4.png)
Summary margin report example
Access the margin reports![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
- Navigate to the Reports hub in your Stripe Dashboard.
- Click Connect Margin Report.
- Using the month picker, select the time-period for which you’d like the Margin Report. The report for a month is available 7 days after the end of that month.
- Click Download on your desired Margin Report type.
Available columns for each margin report![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
The Summary margin report shows aggregated monthly data, while the Transaction margin report shows data for individual transactions.
Note
The total amounts shown in the Summary margin report are normally greater than the sum of the amounts in the Transaction margin report. That’s because the Transaction report includes only fees that apply at a transaction level. It doesn’t include out-of-band fees, such as Card Account Updater fees or non-transactional scheme fees.
Summary margin report![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
This report shows the aggregated volume, revenue, and costs for the platform for the entire month.
Amount fields include:
- subtotal_amount: Amount excluding any tax
- tax_amount: Amount of tax
- total_amount: sum of
subtotal_
andamount tax_
amount
The Summary margin report includes the following data:
Type | Category | Description |
---|---|---|
Volume | Charges, Payment method = {payment method} | Volume of charges for the {payment method} payment method |
Refunds | Volume of refunds | |
Disputes | Volume of disputes | |
Revenue | Application fee, payment method = {payment method} | Amount of application fees for the {payment method} payment method |
Application fee refunds | Amount of application fees refunded by the platform | |
Network fee (assessed by card networks) | Card payments - Transaction network costs | Interchange (or discount, for Amex) fees and transaction-level scheme fees; a single charge typically incurs one interchange fee and one or more scheme fees |
Card payments - Other network costs | Non-transactional scheme fees, such as FANF or MLF, assessed monthly | |
Stripe fee | Stripe processing fees - {payment method} | Stripe processing fees for cards and other payment methods |
Connect - {fee type} | Connect fees, such as Account Volume Billing, Active Account Billing, and (for Stripe Managed Risk and Support) Loss Liability | |
Varies | Other product fees that apply to the platform, such as for Radar and Card Account Updater |
Transaction margin report![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
This report shows a transaction-level breakdown of volume, revenue, and costs for the entire month. It doesn’t include non-transactional fees. You can use it to understand which transactions are margin-positive, margin-neutral, or margin-negative.
Charge detail fields include:
- charge_id: Unique identifier of the charge
- connected_account_id: Unique identifier of the connected account associated with the charge
- activity_at: Time in UTC at which we attribute the line item
- payment_method_type: Type of payment method used for the transaction, such as
card
,ACH credit transfer
, orlink
- card_funding: Card funding type; can be
credit
,debit
,prepaid
, orunknown
- card_brand: Card brand; can be
American Express
,Diners Club
,Discover
,Eftpos Australia
,JCB
,MasterCard
,UnionPay
,Visa
, orUnknown
- card_network: Identifies which network processed the transaction; examples include
amex
,cartes_
,bancaires diners
,discover
,eftpos_
,au interac
,jcb
,mastercard
,unionpay
,visa
,unknown
- card_country: Two-letter ISO code representing the country of the transaction card
- connected_account_country: Two-letter ISO code representing the country of the transaction account
The Transaction margin report includes the following data:
Type | Category | Description |
---|---|---|
Volume | amount | Amount of the charge, excluding any tax |
amount_refunded | Amount of the charge that was refunded | |
amount_disputed | Amount of the charge that was disputed by the customer | |
Revenue | application_fee_amount | Amount requested by the platform to be deducted from the charge amount |
application_fee_amount_refunded | Application fee amount that was refunded | |
Cost | stripe_processing_fees_subtotal_amount | Fees charged by Stripe for payments processing, such as fees for using payment methods like Affirm or AfterPay; for users with IC+ pricing, does not include Stripe card payments fees or network costs |
stripe_processing_fees_tax_amount | Tax on the fees charged by Stripe for payments processing | |
stripe_dispute_fees_subtotal_amount | Dispute fees charged by Stripe | |
stripe_dispute_fees_tax_amount | Tax on the dispute fees charged by Stripe | |
stripe_refund_fees_subtotal_amount | Stripe processing fees that were refunded | |
stripe_refund_fees_tax_amount | Tax on the Stripe processing fees that were refunded | |
network_costs_subtotal_amount | Interchange (or discount, for Amex) fees and transaction-level scheme fees; a single charge typically incurs one interchange fee and one or more scheme fees | |
network_costs_tax_amount | Tax on the transaction-level network costs charged to the platform | |
stripe_per_auth_fee_subtotal_amount | Per-authorisation fees charged by Stripe for card processing with IC+ pricing | |
stripe_per_auth_fee_tax_amount | Tax on the per-authorisation fees charged by Stripe for card processing with IC+ pricing | |
stripe_volume_fee_subtotal_amount | Volume fees charged by Stripe for card processing with IC+ pricing | |
stripe_volume_fee_tax_amount | Tax on the volume fees charged by Stripe for card processing with IC+ pricing | |
stripe_other_cardpayments_fees_subtotal_amount | Other fees charged by Stripe for card processing with IC+ pricing | |
stripe_other_cardpayments_fees_tax_amount | Tax on the other fees charged by Stripe for card processing with IC+ pricing | |
stripe_radar_fees_subtotal_amount | Radar fees charged to the platform | |
stripe_radar_fees_tax_amount | Tax on the Radar fees charged to the platform | |
stripe_adaptive_acceptance_fee_subtotal_amount | Adaptive acceptance fees charged to the platform | |
stripe_adaptive_acceptance_fee_tax_amount | Tax on the adaptive acceptance fees charged to the platform | |
stripe_connect_loss_liability_fee_subtotal_amount | Loss liability fees charged by Stripe to manage risk on the transaction | |
stripe_connect_loss_liability_fee_tax_amount | Tax on the loss liability fees charged by Stripe to manage risk on the transaction | |
stripe_other_fees_subtotal_amount | All other fees charged on the transaction that aren’t explicitly included in another field | |
stripe_other_fees_tax_amount | Tax charged on the other fees | |
currency | Currency of the charge and fees |