Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
Overview
Billing
OverviewAbout the Billing APIs
Subscriptions
Invoicing
Usage-based billing
Quotes
Customer management
Billing with other products
Revenue recovery
Automations
Revenue recognition
Test your integration
Tax
Overview
Use Stripe tax
Manage compliance
Reporting
Overview
Select a report
Configure reports
Reports API
Reports for multiple accounts
Revenue recognition
    Get started
    How Revenue Recognition works
    Data freshness
    Pricing
    Multi-currency
    Connect platforms
    Revenue Recognition for Usage-Based Billing
    Revenue contracts
    Reports
    Overrides
    Audit your numbers
    Examples
    Revenue recognition rules
      Create a rule
      Examples
    Revenue Recognition settings
    Map to your chart of accounts
    Performance obligations API
    Import data to Stripe
    Export data from Stripe
Data
OverviewSchema
Custom reports
Data Pipeline
Data management
HomeRevenueRevenue recognition

Revenue Recognition rules

Customise rules to handle revenue treatments to your business.

Configure Revenue Recognition rules to define revenue treatments specific to your business.

Stripe Revenue Recognition allows you to configure custom rules to handle revenue treatments specific to your business needs. For example, you can configure a rule to:

  • Categorize an invoice line item as a tax or fee
  • Book a transaction amount or invoice line item as a passthrough fee
  • Exclude transactions from specific customers or test invoices
  • Amortize revenue over a specified time period relative to payment or invoice finalization date
  • Recognize revenue after a specific time period to model a future fulfillment schedule
  • Allocate multiple revenue treatments to a single transaction amount

Rules are usually applied to reports within 24 hours. Rules that have successfully been applied in the latest report have an active status. Rules that haven’t remain in a processing status.

Default rules

Stripe Revenue Recognition provides a set of default rules to model the methodology for handling common Stripe resources.

  • For invoice line items with service periods, the line item amount amortizes evenly over its service period. If a period isn’t set on an invoice line item, the amount is recognized entirely when the invoice finalizes.
  • Other payments not made through an invoice are recognised immediately upon payment if no service period or fulfilment information exists, or by the imported service period or fulfilment data.
Default rules

Custom rules

Custom rules override Stripe’s default revenue treatment behaviors where applicable and you can add or modify them on the Stripe Dashboard.

You can apply rules to:

  • Products
  • Customers
  • Invoice line items
  • Other payments (that is, payments that aren’t associated with invoices)

See how to create a rule and define revenue treatments. You can also explore sample rules on tax treatment, pass-through fees, exclusion, and custom time periods.

Rule ordering and hierarchy

Each transaction can only have one rule applied to it when processing revenue reports. In situations where a single transaction fits the “Apply-to” criteria for multiple rules, rule hierarchy determines which rule to apply to the transaction. The higher a rule is ranked on the list, the higher the priority it’s assigned.

You can rearrange the order of the rules by clicking Change rule order as shown below:

Rules

After clicking Change rule order, you can reorder the rules to adjust their priorities.

Rule order

Best practices for effectively maintaining your rules

As your business grows, it’s important to make sure you regularly maintain your rules to ensure the accuracy of your revenue reports. The following are some best practices to keep rules correct for your Revenue Recognition reports.

Know when to create a rule

When applied correctly, Stripe’s default rules and revenue treatment methodology for handling subscription events accurately recognize and defer revenue for businesses who require more control over their unique use.

Regularly monitor rules to ensure they’re up-to-date

Billing models, customer types and edge cases can regularly change, and you should evolve your rules accordingly. To make sure that revenue treatments remain predictable, periodically check your rules so they’re up-to-date in terms of hierarchy and effective period.

Check if your accounting period is open or closed when new rules are applied

If the effective period for a new rule overlaps with a closed accounting period, it generates corrections if the rules are retroactively applied to transactions from past (closed) accounting periods. If you want to avoid this, reopen your books by opening your accounting period prior to adding the rule.

See also

  • Create a rule
  • Examples
Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access programme.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc