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
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
    Overview
    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
    Revenue Recognition settings
    Map to your chart of accounts
    Performance obligations API
    Import data to Stripe
    Export data from Stripe
    Standalone selling price
Data
Overview
Business and product data use cases
SchemaData freshness
Sigma
Data Pipeline
Import external data
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:

  • Categorise 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.
  • Amortise revenue over a specified time period relative to payment or invoice finalisation date.
  • Recognise revenue after a specific time period to model a future fulfilment 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 recognise and defer revenue for businesses that require more control over their unique use.

  • Regularly monitor rules to make sure they’re updated: Evolve your rules accordingly for billing models, customer types and edge cases that can regularly change. 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 applying new rules: If the effective period for a new rule overlaps with a closed accounting period, it generates corrections if you retroactively apply the rules to transactions from past (closed) accounting periods. To prevent this, re-open your books by opening your accounting period prior to adding the rule.

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