Launch catalog / Playbook
Stripe App Marketplace
Conditional free route directory
Researched from public pages — no submission was run · sources read 2026-09-26. Rules change — recheck the platform's own pages before submitting.
What the free route requires
- Listing requires a real Stripe App built with the Stripe Apps framework (manifest, permissions, upload via CLI) — not a listing-only directory
- Only one app per Stripe account; English-language listings only; business must not be on Stripe's Prohibited and Restricted Businesses list
Requirements
- Activated Stripe account
- An app built with Stripe Apps (stripe-app.json manifest, distribution_type 'public', required permissions granted via CLI)
- Upload via `stripe apps upload`; listing written in Dashboard (name ≤35 chars without 'Stripe'/'app'/'free'/'paid' etc., icon ≥300x300 PNG/JPG under 10MB matching the manifest logo, subtitle ≤80 chars, about ≤1000 chars)
- OAuth apps must submit the Live-mode Public Install URL (marketplace.stripe.com/oauth/v2/authorize?client_id=...) — the External Test URL is not valid for review
- allowed_redirect_uris must not contain localhost or dummy URLs
- App review takes ~4 business days; resubmission required after changes
Prepare before opening the form
- Working Stripe App (data integration or UI extension) built and tested — sandbox_install_compatible recommended
- Stripe CLI installed; manifest set to distribution public
- Logo (≥300x300, square PNG/JPG), app name, subtitle, about copy, category choice
- Live-mode Public Install URL for OAuth apps; third-party OAuth providers fully verified
Workflow
- Create and build the app via the Stripe Dashboard / Stripe Apps CLI
- Set distribution to public (`stripe apps set distribution public`) and grant needed permissions
- Upload the app (`stripe apps upload`) and select the version on Dashboard > Developers > Apps
- Write the marketplace listing (value proposition section + use-case sections, required fields above)
- Submit for review — wait ~4 business days; respond to change requests
- On approval the app is published and discoverable at marketplace.stripe.com
- After publishing, partner with Stripe via the promote-app docs for more discoverability
Watch for
- Only ONE app per account — a second product needs a second Stripe account
- Listing is locked while under review; changes require resubmission and re-review
- Connect-based auth is deprecated — use OAuth 2.0 with the public install link
- Subscription upgrade buttons must route to your own site first before Stripe Checkout
- Removing an app requires contacting Stripe — no self-serve unpublish noted
What counts as live
The app has a public listing page at marketplace.stripe.com/apps/<app> discoverable via Marketplace search
Not verified
- Whether listing involves any fee — the publish docs describe review but no listing fee was seen
- Exact discoverability/ranking factors beyond the promote-app partnership program