Atomic revenue splits

Answers the question

How do I split revenue between platform and creator?

Summary

Revenue splits become easier to operate when the payment record and payable state are created together. Soledgic's `record_sale_atomic` posts the platform fee and creator share in a single database transaction with double-entry invariants. If the math does not balance, the transaction does not commit.

Primitives in play

• record_sale_atomic

  Single RPC: debit cash, credit creator_balance + platform_revenue in one transaction.

• creator_balance accounts

  Per-creator balance accounts. Real-time queryable via `get_balance`.

• product_splits / creator_tiers

  Per-product or per-tier split overrides; falls back to platform default.

• risk_signals

  Refund-rate, dispute, and velocity signals flow back into capability gates.

How it fits together

1. Set the platform default split. When you create a ledger, set `default_platform_fee_percent`. New creators inherit this.
2. Override per creator (optional). When you upsert a creator, pass `defaultSplitPercent` to override the platform default.
3. Override per product (optional). Add a `product_splits` row with `creator_percent` to override for a specific SKU.
4. Take payment. Create a checkout session — split metadata travels with it. On payment, `record_sale_atomic` fires.

Code

await soledgic.creators.upsert({
  externalCreatorId: 'creator_maya',
  email: 'maya@example.com',
  defaultSplitPercent: 95,   // 95% to creator, 5% platform fee
})

const session = await soledgic.purchases.create({
  creatorId: 'creator_maya',
  amount: 5000,              // $50.00 in cents
  productName: 'Template pack',
  successUrl: 'https://app.example.com/success',
})
// When the buyer pays:
//   creator_balance += $47.50
//   platform_revenue += $2.50
// posted atomically with double-entry guarantees.

FAQ

More use cases

• ACH payouts to creators
• Marketplace ledger with double-entry guarantees