Skip to content
SoundSyncAudio software platform

Documentation

FastSpring and SoundSync

Move new checkout to SoundSync or retain FastSpring 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 FastSpring's checkout responsibilities and connects only supported access. A package cannot take over a provider-hosted payment page.

FastSpring: external licensing and customer access

This is the External licensing setup, not Full Store. FastSpring keeps your merchant account, checkout, tax, receipts, monetary refunds and payouts. SoundSync supplies one-time perpetual licenses, customer accounts and downloads where included. To have SoundSync manage payments and tax instead, use Move checkout to SoundSync and move-checkout-to-soundsync.md for your independent website or SoundSync hosted store. The kit cannot change who processes a FastSpring-hosted checkout.

Connect external purchases

1. Create your SoundSync developer account and a serial-enabled, one-time product. For beta activation use temporary beta serials/manual grants. Subscriptions, bundles, expansions, preorders and gifts to another recipient are outside this connector's first version; keep these disabled for mapped products.

2. Open External checkout connections from Custom API or Brand & Domain. Create a Test → FastSpring connection. You need API-key management permission and all-product workspace scope. This does not require SoundSync payout onboarding because FastSpring holds these sales proceeds.

3. Map the exact FastSpring product path to the SoundSync product ID. A product name or SKU is not a substitute for its FastSpring path. Optionally save its public HTTPS FastSpring checkout/product URL, using fastspring.com or onfastspring.com, if your website will request checkout links through the API.

4. Click Get setup instructions. In FastSpring, open each mapped product's Fulfillments → Generate a License → Script (JavaScript). Paste its generated private fulfillment script and choose Single-Line License (Quantity Based). Repeat per product. The script runs on FastSpring's servers; an external-purchases-only installation needs no additional merchant-hosted server.

5. In FastSpring's webhook settings add the generated webhook URL and HMAC SHA256 secret. Turn webhook expansion on and select order.completed, return.created, order.failed and order.canceled. Copy the script and secret exactly. Keep them out of customer receipts, plugin binaries, public code and screenshots. Different connections/environments use different credentials.

6. Click Check configuration, then Enable connection. The check validates saved configuration, not a real hosted purchase. Run a purchase through FastSpring's Test mode using its test checkout method. Never switch a live checkout to sandbox to test this integration. Check quantity, receipt serials and integration activity. On SoundSync production, a Test connection returns simulated SS-TEST keys without usable customer access. For the complete customer journey, create the Test connection in Website Builder → Evaluate & Test: a confirmed provider test purchase issues a normal-format serial, customer-library access and downloads inside that isolated environment. Use the matching Practice JUCE package and the purchase email to test activation. No production license, developer bill or payout is created.

7. Re-deliver the test completion event: it must not issue duplicate keys. Make a FastSpring test full refund and verify the event is processed; test a partial refund as well. Full product returns remove the connector's original grants; partial/ambiguous returns require license review and preserve access. FastSpring processes the money refund, while SoundSync changes access. Already-offline devices follow their configured validation grace period.

8. After hosted tests pass, deliberately create a separate Live connection and repeat mappings, scripts and webhooks for live products. Never mix Test settings with live fulfillment. Production serials become usable only after the matching signed completed-order event. A fulfillment reservation or browser success URL alone does not grant access. Signed refunds still remove access while new fulfillment is paused.

Add your existing website

Choose your framework under Custom API, download its hookup and follow its README and HOOKUP.md. Verify your HTTPS website with SoundSync's TXT record, save its callback paths and keep the private website key/customer sessions on your platform. You keep your design and current host.

Set SOUNDSYNC_WEBSITE_MODE=external, SOUNDSYNC_CHECKOUT_PROVIDER=fastspring and SOUNDSYNC_EXTERNAL_ENVIRONMENT=test on the platform (or equivalent WordPress constants), then save checkout URLs on the Test mappings. Deliberately change the external environment to live when ready. The website button opens the saved FastSpring URL; it does not create a SoundSync payment. You can also keep FastSpring's own popup/hosted checkout buttons and use the SoundSync portal for accounts/library only. FastSpring calculates the final tax and price; do not add a SoundSync tax quote on top.

Add your website's account/library URL to FastSpring fulfillment emails alongside the generated license keys. Buyers register and verify the same email used at purchase. SoundSync does not silently verify an email, set a password or opt a purchaser into marketing from a webhook. Once confirmation arrives, their perpetual licenses and authorized downloads appear in the library. An external purchase does not become a SoundSync checkout sale or payout balance; normal service and external-redemption usage pricing still apply.

If you do not need a custom account page, use the generated SoundSync library link in the receipt instead. For missing delivery check the product path, environment, enabled mapping, signed event log and buyer email. Retry the original event after correcting a temporary error; do not create another sale. If a secret is exposed, pause the connection and replace it with a new connection before resuming.

Official references: https://developer.fastspring.com/docs/checkout-and-orders-overview · https://developer.fastspring.com/docs/license-key-fulfillments · https://developer.fastspring.com/reference/message-security · https://developer.fastspring.com/reference/ordercompleted

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.