Skip to main content
Assigning an item to a consignor tells Supercycle that the consignor owns that stock and earns a share of its revenue. Assign one item from its page in Inventory, or several at once from the Inventory table. See Assign an item to a consignor. Every item uses its consignor’s revenue share, whether that’s the shop default, a percentage, or a formula. There’s no rate on the item itself. To treat one item differently, add a custom field to it and read the field in the formula, for example item.fields.payout_rate.

​
How revenue share is calculated

A consignor’s balance moves from what their items actually earn, not from what you list them at.
1

A charge is paid

When a charge on a consigned item is paid, Supercycle records an earning for the consignor.
2

The formula renders

Supercycle resolves the consignor’s revenue share, or the shop default when they inherit, then renders it against the charge, cycle, item, and consignor, and records the result in cents.
3

The amount is frozen

The formula text, basis, amount, and source are saved with the earning. Changing a revenue share later applies to future earnings only.
4

Refunds reverse proportionally

If the charge is refunded, Supercycle records a refund entry that reverses the same proportion of the original amount. The formula isn’t rendered again.
Every earning and refund is itemized in the payout breakdown when you settle the balance.
Revenue share is calculated when a charge is paid, so an order that’s placed but not yet paid doesn’t add to a consignor’s balance until you collect the payment.