Earnings
Earnings pays Suppliers, Partners and affiliates their earnings through Stripe, holds disputed amounts, and sends statements and year-end tax filings.
Earnings pays Suppliers, Partners and affiliates what they earned through Stripe, holds disputed amounts, and sends statements and year-end tax forms. Each payout traces to the accepted work or the Referral that earned it.
Summary
| Part | This System |
|---|---|
| Group | Finance |
| Status | Beta: it works, and its Verbs may still change |
| Shelf | Front: offered from a Startup’s first days |
You can ask:
- “Pay my suppliers”
- “Hold this payout”
- “Release the held payout”
- “When do my suppliers get paid?”
What you get
| Part | This System |
|---|---|
| Starts | Opt-in: it wakes with the Product Templates that need it (Marketplace, Licensed-human marketplace, E2E managed service). |
| Built from | Payment rails, Contractor payments, Workflows |
Nouns it owns
None.
Verbs
| Verb | Object | Approval | Event |
|---|---|---|---|
| Human.remit | Human | Asks first; waits 1 business hour | Human.remitted |
| Human.hold | Human | None | Human.held |
| Human.release | Human | None | Human.released |
| Company.submit | Company | Asks first; waits 1 business hour | Company.submitted |
Events
| Direction | Event | How |
|---|---|---|
| Emits | Human.remitted | By Human.remit |
| Emits | Human.held | By Human.hold |
| Emits | Human.released | By Human.release |
| Emits | Company.submitted | By Company.submit |
| Consumes | Order.paid | Acts on it |
| Consumes | Transaction.settled | Acts on it |
States
None.
Who operates it
| Part | This System |
|---|---|
| Accountable | Treasurer |
| Team | Finance Team |
| Seat | A role agent holds it until a Human is seated. |
| Autonomy | assist |
| Also calls its Verbs | Supply Manager, Finance Lead, Billing Specialist, People Lead, Payroll Specialist |
Approvals and limits
| Verb | Rule | Detail |
|---|---|---|
| Human.remit | A person says yes first | Waits 1 business hour |
| Company.submit | A person says yes first | Waits 1 business hour |
Processes that use it
| Process | How it uses it |
|---|---|
| Supply | A step calls Human.remit |
| Books | A step calls Company.submit |
| Payroll | A step calls Human.remit |
| Hiring | A step calls Human.remit |
| Supplier payouts | A step calls Human.hold |
| Staffing | A step calls Human.release |
Rail underneath
Stripe’s products (Stripe’s names): Connect, Payments.
| Capability | Runs on |
|---|---|
| Contractor payments | apis.tax |
Views and dashboards
| View | Shows | Metrics |
|---|---|---|
| Earnings | What each Supplier has earned, what is held, and what is on its way. | None. |
| The Treasurer’s view | The Metrics its accountable Role answers for. | Runway days |
Access
What each Access level may call here.
| Access level | May call |
|---|---|
owner | Every Verb (4) |
admin | Only 2 of 4: Human.hold, Human.release |
member | Only 2 of 4: Human.hold, Human.release |
viewer | Nothing |
Import and export
None.
Fees and pricing
Stripe’s payout cost passes through at cost on each payout, booked as its own Entry; the platform fee was withheld once, from the sale.
Availability and limits
| Part | This System |
|---|---|
| Status | Beta: it works, and its Verbs may still change |
Compliance notes
Stripe verifies each payee before the first payout; confirming a payee’s tax status stays the founder’s.
Controls it carries:
Related Systems
Example
A Marketplace of freelance translators pays each translator weekly, seven clearance days after the buyer accepts a job. One job is in Dispute, so Human.hold sets that amount aside and Human.remit pays the rest. When the Dispute closes in the translator’s favor, Human.release frees it for the next payout.