Skip to main content
Every campaign has a published commission policy. The policy defines the amount the merchant is willing to reward and how that amount is divided across eligible contributors.

​
The policy fields

Money is calculated in integer token base units. The API represents it as decimal strings, avoiding floating-point rounding.

​
A worked example

This is an illustrative policy, not an offer or revenue claim:
  • Product price: 100 SDUSD.
  • Reward rate: 10%, with a per-sale cap high enough to allow 10 SDUSD.
  • Four paid levels with nearest-first weights 50% / 25% / 15% / 10%.
  • Sufficient funded budget and remaining campaign liability capacity.
The 100 SDUSD buyer payment and the 10 SDUSD merchant-funded reward are separate. The reward is not silently deducted from the buyer payment.

​
Short paths

If a sale has fewer eligible contributors than the policy’s maximum, the configured short-path rule determines the result:
  • Renormalize existing: divide the reward proportionally across the eligible weights. With only the first two people in the example, the ratio is 50:25, or approximately two-thirds and one-third.
  • Return unused: allocate the existing levels’ original shares and leave the unused share in the merchant’s reward budget.
Integer rounding is deterministic. Any allocation remainder is assigned to the nearest eligible contributor. The application preview shows the actual amounts for the current path.

​
Budget and liability are real constraints

A percentage alone does not promise a payout. The contract also checks the funded budget, policy caps, campaign state, and path eligibility. A campaign that cannot meet its required reward reservation cannot accept the purchase under those terms. Direct purchases with nodeId = 0 reserve no distributor reward.

​
Changing a policy

A merchant can register one upcoming version at a time, with at least 24 hours’ notice. The version becomes eligible at its effective time. Existing purchases retain the policy and allocations they accepted; later policy changes do not rewrite them. The hold period, rate, and path on the receipt are the terms to inspect when reviewing an existing sale.

​
Additional policy constraints

The full policy also includes rewardToken, expiry, and eligibilityHash. The current deployment uses the single supported six-decimal token. A scheduled policy cannot change the campaign’s token. The hold must be between 60 seconds and 90 days. Weights must be positive, have exactly the selected level count, and sum to 10,000. The per-sale cap cannot exceed the campaign liability cap. At campaign creation, expiry must be in the future and no more than 365 days away. A scheduled version must become effective before the current expiry, its own expiry must be after its effective time, and that expiry cannot extend beyond 365 days from the campaign’s creation. The notice requirement is enforced against chain time. Use worked integer examples to reproduce short-path rounding and vault accounting to distinguish available funding from remaining liability capacity.