Documentation
Test Your Existing Website
Connect an independent staging frontend without changing live keys, callbacks, payments or customer sessions.
SoundSync
Repeat the journey on your own site
-
Choose the payment model
Full Store uses SoundSync-managed checkout and applicable tax. External licensing keeps supported provider purchases, payments, refunds and tax with that provider. A provider’s hosted checkout cannot be re-skinned into SoundSync checkout by a starter ZIP.
-
Verify staging
In the isolated workspace’s Custom API, save the exact HTTPS staging origin and callback paths, verify its TXT record and create a private test website key. Do not replace the live website’s settings to run a test.
-
Pin the environment
Use the displayed test API origin and expected-environment header. Restart the private platform after changing configuration. Set both origin and environment; a browser request field cannot switch production payments into test mode.
-
Keep secrets on the platform
Store customer tokens, MFA challenges and website keys in private server sessions. Do not put them in browser storage or distribute the private website key inside a plugin.
-
Test the product-page flow
Catalog > product > register/verify/sign in > paid checkout or Get it free > customer library > private download. Maintained starters preserve the selected product/offer through account setup in the customer’s private session.
SoundSync
Choose the integration for your own site
Account and website sessions have separate clocks
Account tokens expire after 30 days, or earlier after applicable security/revocation events. JSON login returns session.expiresAt, expiresInSeconds and refreshSupported:false. There is no refresh-token endpoint. Starter private website sessions default to 24 hours. A longer cookie does not extend the API token: ask the customer to sign in again after expiry or a 401, without storing a password for silent login.
Free claims start on the product page
A verified customer uses Get it free on the selected $0 product, then views the scoped library. New interfaces do not put a free-download purchase button on the checkout page or inside the library. POST /api/checkout/claim rejects a positive server-calculated price and does not open paid checkout. The older checkout/product claim transport remains compatible.
SoundSync
Choose the actual adapter
Custom API
Use HTTPS/JSON from your own server language. Implement private sessions and the customer journey yourself; this is an API path, not a downloadable SDK for every language.
Astro / Node.js
Merge Astro server routes, account components and product pages into a server-enabled site. A static-only export needs a platform for private sessions and keys.
Node.js / Express
Mount the Express routes and customer portal in your existing Node platform. Retain your own hosting, process management and persistent session storage.
Next.js / React
Use the editable Next.js App Router handlers and React customer pages. Keep SoundSync calls and session credentials in the Node server runtime.
Nuxt / Vue
Connect Nuxt server routes and Vue customer pages through Nitro. Configure private runtime settings and trust only your actual hosting proxy.
SvelteKit
Merge SvelteKit server endpoints and pages with adapter-node. Keep server sessions, asset paths and verified visitor-IP handling configured for your host.
PHP / Laravel
Use the private PHP client or Laravel route adapter. Preserve CSRF protection and server-side session storage; PHP and Laravel are not browser-only clients.
WordPress / WooCommerce
Place product, account and checkout shortcodes inside your current theme. WordPress login and SoundSync customer login remain separate.
FastSpring
Move new website buy buttons to SoundSync checkout, or keep FastSpring payments and connect supported external perpetual-license purchases. These are different payment models.
Gumroad
Keep your own frontend and move new checkout to SoundSync, or verify supported Gumroad sales through the external licensing connection. Catalog migration does not transfer subscription billing authority.
WooCommerce payments
Use SoundSync checkout from your own website, or retain WooCommerce and its gateway while connecting supported external purchases to licensing. Variation mappings and authenticated notifications matter.
