Skip to content
SoundSyncAudio software platform

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.

StatePayment meaningCustomer accessDeveloper balance impactDownload behaviorPlugin behavior
paidPayment 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.
refundedFull 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_refundedPartial 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.
disputedDispute/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.
failedPayment failed before durable checkout completion.No durable access.No sale ledger entitlement grant.No protected downloads.No activation eligibility.
canceledCheckout 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.
migratedHistorical/imported order record. Product catalog migration creates reviewed product drafts, not a transfer of historical payments.Access can be present if entitlement created by migration.Migration ledger depends on import path.Downloads follow entitlement state.Plugin follows entitlement/license response.

SoundSync

Purchases

Customer invoice and purchase history - Example data; no live transaction or account change.

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.

Receipts keep the accepted discount

Issued purchase views retain the saved automatic promotion, coupon and BOGO detail from the order. Receipt names and codes come from accepted order/item snapshots, including multiple saved purchase-option deals; changing a campaign name later does not rename or reprice an old receipt. A non-financial access grant is not presented as a paid promotion receipt.

Product-version delivery uses the customer's currently permitted files, including the supported current-file fallback when an older release has no attachments; it does not create a new paid major-version tier.