# Commissions

> Commission plans (flat or marginal tiers) assigned to sellers, commissions accrued on the ledger from paid records, statements per period with a payout, and the lines payroll adds.

- Category: Billing & commerce
- Module: `commissions`
- Modes: `managed`, `custom`
- Docs: https://bettersupabase.com/docs/blocks/commissions
- Page: https://bettersupabase.com/blocks/commissions

## Install

```bash
npx better-supabase add commissions
```

The command also installs `updated-at`, `memberships`, `permissions`, `ledger`.

## Configure

Add the block to `better-supabase.config.ts`:

```ts
import { defineConfig } from "better-supabase/config";

export default defineConfig({
  blocks: {
    // Required by commissions; add installs them too.
    "updated-at": {},
    memberships: {},
    permissions: {},
    ledger: {},
    // Modes: "managed", "custom". The default is "managed".
    commissions: { mode: "managed" },
  },
});
```

## Client

The block has no React entry yet. Its server-side TypeScript is in `better-supabase/blocks/commissions`.

## Events

- `commission.accrued`
- `commission.reversed`
- `commission_plan.created`
- `commission_plan.updated`
- `commission_statement.finalized`
- `commission_statement.paid`

## Related blocks

Requires: [memberships](https://bettersupabase.com/blocks/memberships.md), [permissions](https://bettersupabase.com/blocks/permissions.md), [ledger](https://bettersupabase.com/blocks/ledger.md)

Works with: [outbox](https://bettersupabase.com/blocks/outbox.md), [audit](https://bettersupabase.com/blocks/audit.md), [invoices](https://bettersupabase.com/blocks/invoices.md), [periods](https://bettersupabase.com/blocks/periods.md)