Skip to content

Belay: commission disputes

Belay records a partner-initiated dispute against a held, eligible, or approved commission. A partner can open a dispute. A workspace owner or admin can ask a question or record the resolution. Row-level security enforces that role boundary in the database.

Belay supports three categories:

Category Meaning
untracked The sale did not appear in the commission record.
incorrect The recorded amount is wrong. Include expectedAmountMinor.
declined The sale should have been approved.

Your application chooses the time allowed for a response and snapshots the resulting deadline in the opening event.

import { disputeAutoApproveAt, type DisputeEvent } from "tandem-crm";
const openedAt = "2026-09-27T12:00:00.000Z";
const dispute: DisputeEvent = {
id: "dispute_evt_001",
sequence: 1,
workspaceId: "workspace_123",
disputeId: "dispute_123",
leadId: "lead_123",
payoutId: "payout_123",
source: "partner-portal",
sourceEventId: "dispute-form_001",
occurredAt: openedAt,
type: "dispute.opened",
data: {
payoutId: "payout_123",
category: "incorrect",
expectedAmountMinor: 12_500,
description: "The approved rate for this partner was 10 percent.",
autoApproveAt: disputeAutoApproveAt(openedAt, 14),
},
};

An operator can append dispute.queried with a question before resolving the case. Resolution is either upheld or dismissed and requires a note.

import { isDisputeOverdue, replayDisputeEvents } from "tandem-crm";
const state = replayDisputeEvents(
disputeEvents,
"workspace_123",
"dispute_123",
);
const needsAttention = isDisputeOverdue(
state,
new Date().toISOString(),
);

An overdue-dispute database function can append an upheld resolution on a trusted schedule. Your deployment chooses the scheduler.

Belay records the outcome and keeps a payout on hold while a case is open or queried. It does not create a replacement commission, change an amount, or move money. Your application makes any financial follow-up as a separate, reviewable action.

A clawback request on a paid line adds to any clawback already there, for example from a refund, and the total can never pass what was paid. See Lifetime commission for refunds and for recording money you got back.