Skip to main content

​
Active Merchant Model

SuperSeeded uses an Active Merchant billing model. A merchant is marked Active (incurring a $15/month base fee) only upon processing their first billable document in a calendar month.
Merchants who don’t process any billable documents in a month incur no charges for that month.

​
What Counts as Billable?

Document OriginBillableNotes
External upload✅ YesStandard plant schedules uploaded by merchants
SuperSeeded Engine❌ NoFiles tagged with producer: "SuperSeeded_Engine_v1"

​
The SuperSeeded Origin Exemption

Documents generated by the SuperSeeded Engine are exempt from billing. This enables integrated workflows where your platform generates plant schedules programmatically without incurring processing charges.

How It's Detected

The exemption is detected via the producer metadata field in the uploaded file’s metadata. Files with producer: "SuperSeeded_Engine_v1" are automatically marked as non-billable.

​
Row Counting

Usage is tracked at two levels: total rows and billable rows.
MetricDescription
Total RowsAll line items processed across all documents (both billable and non-billable)
Billable RowsOnly rows from billable documents count toward quota and overage

​
Included Quota

Base Fee

$15/month per active merchant

Included Rows

500 billable rows per merchant per month
Rows beyond the 500 included are billed as overage, calculated in the monthly billing report.

​
Usage Tracking Example

Consider a merchant who processes two files in January: 
// File 1: External plant schedule (billable)
{
  "file_origin": "external",
  "rows_processed": 350,
  "is_billable": true
}

// File 2: SuperSeeded Engine output (non-billable)
{
  "file_origin": "superseed_engine",
  "rows_processed": 200,
  "is_billable": false
}
Result for January:
MetricValue
Is Active✅ Yes (processed billable document)
Total Rows550
Billable Rows350
Overage0 (under 500 quota)

​
Monthly Reset

1

New Month Begins

All merchant ledgers reset at the start of each calendar month (YYYY-MM format).
2

Fresh State

Each merchant starts the new month with:
  • is_active: false
  • row_count: 0
  • billable_row_count: 0
3

First Billable Document

The first billable document processed in the month sets is_active: true, triggering the base fee.

​
Monthly Usage Response

When processing a file, the API response includes current month totals: 
{
  "usage": {
    "is_billable": true,
    "rows_processed": 42,
    "file_origin": "external",
    "month_totals": {
      "month": "2024-01",
      "is_active": true,
      "row_count": 592,
      "billable_row_count": 392
    }
  }
}
​
month_totals.month
string
Current billing month in YYYY-MM format
​
month_totals.is_active
boolean
Whether the merchant has been activated this month
​
month_totals.row_count
integer
Total rows processed this month (all documents)
​
month_totals.billable_row_count
integer
Billable rows processed this month (counts toward quota)

​
Billing FAQ

A merchant is billed when they process their first billable document in a calendar month. Non-billable documents (from SuperSeeded Engine) do not trigger activation.
Inactive merchants (no billable documents in a month) incur no charges. They can still process non-billable documents without being activated.
Overage = max(0, billable_row_count - 500) per merchant per month. Overage rates are provided in your Platform agreement.
Yes, every processing response (e.g., verify-pot-sizes) includes month_totals with current usage. You can also visit your account page or query the billing API for aggregated reports.