Commission
A Commission is what a Partner earns on the collected revenue its Referral brings, at a rate over a term, paid after a clawback window.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
rate | number | required | The share of collected revenue earned, as a percent, such as 20. Never randomized. |
term | integer | required | Months after the first payment over which revenue earns the rate, such as 12. Never randomized. |
clawbackDays | integer | required | Days a payment waits before it earns, so a refund inside the window earns nothing. |
earned | money | Collected revenue net of refunds, times the rate, for payments past the clawback window. | |
paid | money | What has reached the Partner so far. |
Object
{
"$id": "https: //api.sb/ patentpad.com/ commissions/ commission_1",
"$type": "Commission",
"rate": 1,
"term": 1,
"clawbackDays": 1,
"earned": {
"amount": 499,
"currency": "USD"
},
"paid": {
"amount": 499,
"currency": "USD"
}
}Relationships
- A Commission has one Referral: the Commission a Partner’s Referral earns on the revenue it brings, self-serve or through a Deal.
referral, inverseearns.
Verbs
createCreates a Commission.POST /{namespace}/commissionsgetReturns one Commission by id.GET /{namespace}/commissions/{id}listReturns Commissions, newest first, one page at a time.GET /{namespace}/commissionsupdateChanges the given properties of a Commission.PATCH /{namespace}/commissions/{id}payPay transfers a Commission’s earned, unpaid amount to the Partner’s connected account through Stripe.POST /{namespace}/commissions/{commission}/pay
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Commission.create | Yes | Yes | Yes | No |
Commission.get | Yes | Yes | Yes | Yes |
Commission.list | Yes | Yes | Yes | Yes |
Commission.update | Yes | Yes | Yes | No |
Commission.pay | Yes | No | No | No |
Call it
Pay the latest commission.Example
An accounting firm refers a client to a payroll app on a Commission of 20% for 12 months with a 30-day clawback. The client pays $300 a month, so the firm earns $60 a month once each payment clears the window.