# GitHub Docs: Handling new purchases and free trials

- Canonical HTML: https://growth.iangoh.com/sources/github-docs-handling-new-purchases-and-free-trials-docs-github-com/
- Original source: https://docs.github.com/en/apps/github-marketplace/using-the-github-marketplace-api-in-your-app/handling-new-purchases-and-free-trials?apiVersion=2022-11-28
- Domain: docs.github.com
- Latest check: 2026-05-31
- Channels: Infrastructure, Marketplaces, Onboarding, Retention

## Cited GrowthDex tactics

- [GitHub Marketplace free trial countdown in billing UI](/growth-ideas/github-marketplace-free-trial-countdown-in-billing-ui/) - Show the remaining GitHub Marketplace trial days inside the product, because GitHub gives the dates and the buyer should not have to guess when paid access starts.
- [GitHub Marketplace setup URL finishes the purchase](/growth-ideas/github-marketplace-setup-url-finishes-the-purchase/) - Build the Setup URL before promotion, because GitHub Marketplace cannot complete a GitHub App purchase flow if the post-install handoff has nowhere reliable to go.

## Related reading

- [GrowthDex Blog](/blog/)
- [All growth ideas](/growth-ideas/index.md)