Documentation
Gumroad and SoundSync
Move new checkout to SoundSync or retain Gumroad 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 Gumroad's checkout responsibilities and connects only supported access. A package cannot take over a provider-hosted payment page.
Gumroad: external licensing and customer access
This is External licensing, not Full Store. Gumroad remains responsible for its payments, taxes, refunds and payouts. SoundSync provides customer accounts, licenses and delivery where included. For SoundSync-managed payments and tax, choose Move checkout to SoundSync and follow move-checkout-to-soundsync.md to replace buy buttons on your own website or use a SoundSync hosted store. A package cannot replace payment processing inside Gumroad's hosted checkout.
1. Create a separate Test connection under External checkout connections. In Gumroad's application/API settings create an access token with view_sales permission. Save it in the connection's private configuration. SoundSync calls the fixed Gumroad API host to verify and bind the seller ID. No refund permission is needed. Never put the token in website JavaScript or the JUCE binary.
2. Find the API product_id for each one-time digital product (GET /v2/products). Map it to the matching serial-enabled SoundSync product. The URL slug after /l/ is not its API ID. Save the public https://…gumroad.com/l/… product URL if your website will start checkout through the hookup.
3. Get the generated private callback URL. Subscribe sale, refund, dispute, and dispute_won to it using Gumroad's resource-subscription API. GET /v2/resource_subscriptions?resource_name=sale lists existing subscriptions. PUT /v2/resource_subscriptions, with Authorization: Bearer <private-token> and form fields resource_name and post_url, registers one subscription; repeat for each resource name and avoid duplicates. Do this from your platform or a private API client, not the browser console. The private callback URL contains an authentication secret; exclude it from public logs/screenshots.
4. Check configuration and enable the Test connection. Notifications are treated as hints: SoundSync reads the actual sale using the saved merchant token, checks seller/product/email and confirmed-sales membership, and applies its current refund/revocation state. An arbitrary posted email/paid flag never grants access. Sample test events with no actual sale are ignored. Production Test connections simulate licenses; Live connections reject seller self-purchases. For customer-library access, downloads and JUCE activation, create a Test connection inside Website Builder → Evaluate & Test, map its test product, register with the purchase email and use its matching Practice JUCE package. Confirmed test sales create usable licenses only in that isolated workspace, without production access, developer bills or payouts.
5. Use the Keep external checkout download, or configure your own framework with SOUNDSYNC_WEBSITE_MODE=external, SOUNDSYNC_CHECKOUT_PROVIDER=gumroad and SOUNDSYNC_EXTERNAL_ENVIRONMENT=test. Save Gumroad product URLs on the matching Test mappings. Select live deliberately after testing. You can also keep native Gumroad widgets. Accounts and library can live on your own site, but payment and tax stay with Gumroad. Do not call this Full Store or add a SoundSync tax quote to those purchases.
6. Add the website account link to the product's content/receipt. Buyers register and verify the purchase email. SoundSync issues its own JUCE-compatible keys; a Gumroad native license key is not a SoundSync serial. Do not enroll purchasers in marketing without consent.
7. Rehearse a test purchase, duplicate notification, full refund and partial refund. Full refund or access revocation removes only this connector's grants. A partial refund requires license review. A won dispute does not automatically restore previously revoked access; review and re-grant deliberately. Provider sale amounts are reference records, not SoundSync payout earnings. The Gumroad API's canonical price is recorded as USD cents, not the displayed buyer currency.
Subscriptions, bundles, physical goods, gifts and preorders are outside this connector's first version. Hosted merchant tests remain required before calling an installation production-ready. No real checkout or refund is performed by installing the package.
Official instructions: https://gumroad.com/api · https://gumroad.com/help/article/44-build-gumroad-into-your-website
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
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.
