Skip to content
SoundSyncAudio software platform

Guide

From Checkout to Product Access

End-to-end checkout workflow from product/cart selection to Stripe Checkout, webhook completion, order, ledger, entitlement, customer library, download, and plugin activation.

Start with getting startedExplore API docs
Live Moonwave FX cart review showing a Luxon subscription line item, tax presentation, Merchant of Record label, and secure payment action.
Live Moonwave FX billing workspace showing current charges, fees, usage, statements, and billing controls.
Live Moonwave FX analytics workspace showing revenue, product, customer, activation, and download reporting.

SoundSync

Minimum Paid Product Price

Products sold through SoundSync checkout must be priced at $9.99 or higher.

Paid checkout rule

Minimum product price: $9.99 for paid products.

Free products

Products can still use supported free, promo, manual grant, reseller, migration, serial-generator, or external-redemption flows where configured. The $9.99 minimum applies to paid products sold through SoundSync checkout.

Checkout validation

Checkout pricing is validated server-side, so product price, sale price, promo codes, subscriptions, and checkout totals should be configured with the paid-product minimum in mind.

SoundSync

Canonical workflow

This is the public implementation sequence.

  1. Cart creation

    Storefront/embed runtime keeps client cart state, but checkout normalizes productId/items/cartItems/lineItems server-side.

  2. Pricing and currency

    Server-authoritative product pricing resolves checkoutPriceCents and defaults currency to usd. Clients must not send authoritative prices.

  3. Discounts

    promoCode, promo_code, or coupon can be validated against server promo rules; automatic checkout offers may apply server-side.

  4. Tax quote

    When internal tax checkout is active, checkout requires a valid server quote and rejects mismatched Stripe totals.

  5. Checkout session

    Stripe session is created with safe success/cancel URLs and stored checkout_sessions metadata.

  6. Completion

    Stripe webhook verifies signature/environment, locks by checkout session, checks total, and creates/reuses order idempotently.

  7. Fulfillment

    Order service writes ledger, serials where supported, entitlements, marketing audience capture, revenue shares, journal/settlement preview, and purchase email if configured.

  8. Customer access

    Library and delivery endpoints expose active entitlement access; plugin activation eligibility follows licensing validation.

SoundSync

Failure behavior

These are the documented customer/developer outcomes.

CaseCurrent behaviorRecovery
Product missingPRODUCT_NOT_FOUND from checkout route.Refresh product/storefront state.
Subscription mixed cartSUBSCRIPTION_CART_UNSUPPORTED for multi-item or quantity subscription carts.Checkout one subscription product at a time.
Legacy reseller checkout contextLEGACY_RESELLER_CHECKOUT_RETIRED.Use Partner Hub/external order reporting.
Tax quote required/mismatchTAX_QUOTE_REQUIRED or STRIPE_TOTAL_MISMATCH.Regenerate quote and do not trust browser totals.
Stripe config not readySafe config errors include stripeMode only for recognized configuration failures.Use test mode until live checkout is enabled/configured.