Skip to content

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

PropertyTypeRequiredDescription
ratenumberrequiredThe share of collected revenue earned, as a percent, such as 20. Never randomized.
termintegerrequiredMonths after the first payment over which revenue earns the rate, such as 12. Never randomized.
clawbackDaysintegerrequiredDays a payment waits before it earns, so a refund inside the window earns nothing.
earnedmoneyCollected revenue net of refunds, times the rate, for payments past the clawback window.
paidmoneyWhat has reached the Partner so far.

Object

JSON
{
  "$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

Verbs

  1. createCreates a Commission.
    POST /{namespace}/commissionsdoCommission.created
  2. getReturns one Commission by id.
    GET /{namespace}/commissions/{id}readNo Event
  3. listReturns Commissions, newest first, one page at a time.
    GET /{namespace}/commissionsreadNo Event
  4. updateChanges the given properties of a Commission.
    PATCH /{namespace}/commissions/{id}doCommission.updated
  5. payPay transfers a Commission’s earned, unpaid amount to the Partner’s connected account through Stripe.
    POST /{namespace}/commissions/{commission}/paydoCommission.paid

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operationowneradminmemberviewer
Commission.createYesYesYesNo
Commission.getYesYesYesYes
Commission.listYesYesYesYes
Commission.updateYesYesYesNo
Commission.payYesNoNoNo

Call it

Text
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.