Operations

Every state-changing call is a kind-tagged Operation that posts a balanced transaction and returns an Outcome.

• Top-up

  Buyer cash becomes spendable credit, valued at the buy rate.

• Spend

  A marketplace sale: the buyer spends, the seller earns, and the platform's fee is split out by the pricing policy.

• Refund

  Return a completed spend, reversing the posting that recorded it.

• Clawback

  Recover funds after a dispute, driven by a processor dispute webhook.

• Request payout

  Open the payout saga: reserve matured earnings for disbursement, subject to minimums and intervals.

• Settle payout

  Mark a submitted payout settled once the provider confirms — a privileged transition a user cannot make for their own payout.

• Reverse payout

  Reverse an in-flight payout; refuses one that has already disbursed USD.

• Subscribe

  Start a subscription, charging the first period's fee.

• Cancel subscription

  Cancel an active subscription.

• Grant entitlement

  Grant ownership of a SKU to an account.

• Revoke entitlement

  Revoke a previously granted entitlement.

• Grant promo

  Issue promotional credit that expires.

• Adjust

  An operator-only manual correction posted to the ledger.

• Reverse

  An operator-only manual undo of a prior posting (distinct from reversing a payout).