Skip to content
SoundSyncAudio software platform

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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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

Current interface example. No production customer or payment record is shown.

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.