Purchase Flow

The public purchase flow returns enabled licenses for a public track, creates a pending purchase for valid checkout, and enables tokenized downloads only after a verified completion webhook.

Finding Licenses on a Public Track Page

Producers who sell licenses through The Library can make an enabled license available from a public track page. You can access that page through the link the producer provides, either directly or embedded on their website.

If licensing is enabled, the public endpoint returns the enabled license options for that track.

Each license option shows:

License name — such as “Non-Exclusive Lease,” “Premium Lease,” or “Exclusive Rights”
Price — the cost for that tier
What’s included — which file formats you receive (MP3, WAV, stems, project files)
Deliverables — the files configured for that license

You don’t need an account to browse. You only need to provide your email when you make a purchase.

Selecting Your License

Choose an enabled license whose configured description, price, currency, and deliverables fit your needs. Any rights and deliverables are seller-defined; confirm them with the seller rather than inferring a fixed meaning from a license name.

Starting Checkout

Checkout requires a valid buyer email address. A buyer name may be supplied where the seller’s flow requests it.

Completing Payment

The seller must have connected Stripe and Dropbox before checkout can start. The Library creates a pending purchase record and download token before it creates the Stripe Checkout session.

Do not treat a browser return as completed delivery. A verified checkout.session.completed webhook marks the purchase complete, sets the download expiry, and sends confirmation. A verified payment failure marks the purchase failed.

After Your Purchase

After verified completion, the purchase-success flow can show the track name, license name, purchase date, download controls, expiry date, and license terms. The purchase is retrieved with its download token.

Download Expiration

Your download links are active for 30 days from the date of purchase. After that window closes, the links expire and you won’t be able to download directly from the page.

If your links expire, the purchase endpoint returns an expired-download response. Contact the producer with your order confirmation for assistance.

What You Receive

The completed-purchase endpoint returns the files configured for the purchased license through fresh temporary Dropbox links. Deliverables and terms are seller-defined; check the configured license details before checkout.

Troubleshooting

Payment Failed

The purchase stays pending until the verified Stripe event is processed. Check the purchase state or contact the seller if it does not complete.

Download Link Not Working

If you can’t access your files after purchase:

Check that the token is valid and the 30-day window has not expired

If the link has expired or you never received the email, reach out to the producer directly with your order confirmation details.

Producer’s Dropbox Disconnected

In rare cases, a producer’s file delivery system may be unavailable. If you see a message about the seller needing to reconnect their storage, contact the producer. Their files aren’t lost — they just need to reconnect their Dropbox account to restore delivery.

Tips

Save your download links immediately — don’t wait until day 29 to grab your files. Download them right away and keep a backup.
Read the configured details before purchasing — deliverables and terms are seller-defined.
Use a valid email address — your download links and purchase confirmation are sent to the email you provide. Double-check for typos.
Screenshot your order confirmation — this makes it easier to resolve issues if you need to contact the producer later.