Attributions
An attribution is the starting point of everything in Coritra. It represents a performance event — something a partner did that earns them a commission. Common examples include a deal they closed, a customer they referred, or a subscription they helped renew.
You record attributions yourself, by pushing events to Coritra via the API whenever something relevant happens in your business.
Attribution schemas
Section titled “Attribution schemas”Before you can record attributions, you define an attribution schema. A schema acts as a template: it specifies what data must be provided each time an event of that type is recorded. For example, a “Closed Deal” schema might require a deal amount, a currency, and a product category.
Every attribution is tied to one schema. When you record it, Coritra validates the data you provide against that schema. This ensures your commission formulas always have the data they need to compute a correct amount.
Lifecycle
Section titled “Lifecycle”An attribution can be in one of two states:
- Confirmed — the event is valid and active. Commissions are calculated from it.
- Cancelled — the event has been voided (for example, a deal that fell through). When you cancel an attribution, its associated commissions are updated accordingly.
What happens after
Section titled “What happens after”Once an attribution is confirmed, Coritra immediately evaluates all commission formulas that apply to it and produces the corresponding commissions. You do not need to trigger this manually — it happens automatically whenever an attribution is created or updated.