Guide
Orders
Order lifecycle, statuses, fulfillment side effects, idempotency, analytics visibility, and access impact.
SoundSync
Verified order states
Only states verified in orderService ORDER_STATUSES and connected refund/dispute services are documented.
| State | Payment meaning | Customer access | Developer balance impact | Download behavior | Plugin behavior |
|---|---|---|---|---|---|
| paid | Payment completed or free claim completed. | Access granted by order entitlements. | Sale ledger entries created; settlement/journal allocation may be created when enabled. | Active entitlements and downloads allowed. | Plugin eligible after entitlement/license validation. |
| refunded | Full refund or reversal recorded. | Access may be revoked by refund policy/event handlers. | Negative/refund ledger and recovery/settlement adjustments may apply. | Downloads blocked when entitlement becomes inactive. | Plugin should lock once validation sees inactive/revoked access. |
| partially_refunded | Partial refund supported by order status enum and refund service. | Access depends on item/refund policy, not assumed universal. | Partial negative adjustment may apply. | Download behavior follows entitlement state. | Plugin behavior follows entitlement/license response. |
| disputed | Dispute/chargeback event recorded. | Access impact depends on dispute policy and recovery workflow. | Recovery/reserve/provisional accounting may apply. | Downloads follow entitlement state. | Plugin follows entitlement/license response. |
| failed | Payment failed before durable checkout completion. | No durable access. | No sale ledger entitlement grant. | No protected downloads. | No activation eligibility. |
| canceled | Checkout canceled or order canceled before access grant. | No new access. | No sale ledger entitlement grant unless another source exists. | No protected downloads. | No activation eligibility. |
| migrated | Imported historical order/access. | Access can be present if entitlement created by migration. | Migration ledger depends on import path. | Downloads follow entitlement state. | Plugin follows entitlement/license response. |
Idempotency
Order creation locks on source/sourceId and returns existing orders without duplicating entitlements when a duplicate provider completion arrives. Stripe checkout completion also uses a checkout-session advisory lock.