Skip to content
SoundSyncAudio software platform

Documentation

WooCommerce and SoundSync

Move new checkout to SoundSync or retain WooCommerce payments with connected perpetual licensing.

Move checkout or keep it external

Move checkout to SoundSync replaces new-sale buttons on your independent website or uses a SoundSync hosted store. SoundSync then manages those new payments and tax. Keep external checkout retains WooCommerce's checkout responsibilities and connects only supported access. A package cannot take over a provider-hosted payment page.

WooCommerce: external licensing or moving checkout to SoundSync

Choose one flow before installation:

* Keep WooCommerce checkout, tax, gateways and monetary refunds; use the signed external connector for SoundSync perpetual licenses and optional customer library.

* Full Store: use the WordPress package and SoundSync product buttons so SoundSync manages payments and tax. Set SOUNDSYNC_WEBSITE_MODE=full_store and SOUNDSYNC_CHECKOUT_PROVIDER=soundsync. These orders live in SoundSync; the package does not replace WooCommerce's native payment gateway or synchronize Woo carts/orders. Follow move-checkout-to-soundsync.md.

For external purchases:

1. Create a separate staging WooCommerce store with test gateway credentials. Create a SoundSync Test connection and save the exact HTTPS WooCommerce store origin (including its subdirectory if applicable is not supported: use the store's origin and standard root webhooks). Configure a separate secret for every connection/environment. Never point a staging store at a Live connection: WooCommerce has no universal cross-gateway test-mode flag.

2. Map Woo numeric product IDs or variation IDs to matching serial-enabled one-time SoundSync products. These are not SKUs. Only mapped items grant licenses. Save same-origin Woo product checkout URLs if your own website API will return external checkout links.

3. In WooCommerce → Settings → Advanced → Webhooks, create three Active webhooks: Order created, Order updated, Order deleted. Copy the generated SoundSync Delivery URL and HMAC secret to each. Initial form pings are accepted but do not create licenses. JSON notifications require a matching source origin and HMAC-SHA256 signature over raw bytes.

4. Check configuration and enable the Test connection. Only paid-date orders in processing/completed status fulfill. Pending/on-hold orders do not grant access. Full refunds and cancellations remove this connector's licenses. Partial refunds are flagged for review and preserve access. SoundSync does not send a monetary refund request to WooCommerce or its gateways. Production Test connections simulate licenses. For a full customer journey, use a Test connection in Website Builder → Evaluate & Test; confirmed staging orders create usable licenses, customer-library access and downloads only in that isolated workspace. Register with the purchase email and use the matching Practice JUCE package. No production access, developer bills or payouts are created.

5. For external licensing, install [soundsync_account] or another customer portal and keep native Woo checkout buttons. To use saved Woo checkout URLs, set SOUNDSYNC_WEBSITE_MODE=external, SOUNDSYNC_CHECKOUT_PROVIDER=woocommerce and SOUNDSYNC_EXTERNAL_ENVIRONMENT=test for staging, selecting live deliberately later. Your store/gateway remain responsible for payment and tax. Woo and SoundSync logins are separate; buyers verify their purchase email. Add your account link to Woo receipts. No Woo passwords or historical orders are automatically imported.

6. Run staging purchase, duplicate webhook, unpaid order, full refund, partial refund and revoked-download tests. Confirm no payout/processing ledger is created in SoundSync for Woo payments. Check Woo webhook logs: repeated failures disable delivery. Fix the issue, re-enable and redeliver the original notification; do not create another purchase.

7. After hosted rehearsals, create a separate Live connection, configure the live store and mappings, then deliberately enable it. Subscription lifecycle events, bundles, gifts and preorders require separate rules and must not be mapped as perpetual purchases.

Read website-hookups.md / HOOKUP.md for website verification, sessions, private R2 delivery and launch checks. Official webhook guide: https://woocommerce.com/document/webhooks/

External purchases are not managed checkout

A verified external purchase can grant a one-time perpetual license through a configured FastSpring, Gumroad or WooCommerce connection. It does not make SoundSync the merchant for that purchase, move its tax obligations or pay the external provider's fees. Refund the money through the original provider; authenticated full-return events remove only the connector's original access. Partial or ambiguous returns require license review.

A provider notification does not silently verify the buyer's email, create a password or enroll the buyer in marketing. Customers separately use the current verified account/claim flow. Signup and eligible SoundSync purchase enrollment retain the published marketing policy, including unsubscribe and suppression protections.

Keep the buyer journey clear

Add the customer account/library link to the provider receipt, never private connection credentials. Buyers verify the same purchase email. Optional saved checkout URLs must match the allowed provider/store origin. They do not calculate SoundSync tax or confirm payment. Preserve historical purchases and refund handling when moving new sales.

SoundSync

Detailed references

External Checkout Connections API

Mapping, check, enable, setup, retry and authenticated provider routes.

Website setup

Keep your frontend and choose the correct service flow.

Pricing and usage

Current service tiers and external-redemption allowance.

SoundSync

Test this hookup without changing your live site

Staging integration checklist

Use the separate API, verified staging callbacks and test key; repeat account, paid/free, library and plugin access.