Monetization: Checkout and Plan Changes in the Developer Portal
The monetization plugin for the Developer Portal
(@zuplo/zudoku-plugin-monetization) gives you more control over how customers
reach checkout. Custom plans can send buyers to your sales team, you can ask
qualifying questions before payment, and existing subscribers who follow a
checkout link land in a plan change instead of a second subscription.
- Contact sales for custom plans: Replace Subscribe with a link to your sales team
- Questions before checkout: Collect company size or use case before Stripe
- Checkout links that know the subscriber: Existing customers switch plans instead of starting over
Contact sales for custom plans
A plan with isCustom set to "true" in its metadata shows Custom and
Contact Sales in place of a price. Add a contactUrl to the same metadata
in the Zuplo Portal, and the pricing page and the plan switcher render a button
to it in place of Subscribe. The target can be a full URL, an email address
(turned into a mailto: link), or a path in your Developer Portal. Set
contactLabel to change the button text.
Ask questions before checkout
The new checkout.renderBeforeCheckout option renders your own form on the
checkout page after a customer clicks Subscribe and before they reach
Stripe. Save the answers wherever you need them, then call onComplete() to
continue to payment. Return null to skip the form for a plan, such as a free
tier.
No Stripe Checkout session exists until onComplete() fires, so customers who
abandon the form don’t leave expired sessions behind.
Plan changes from checkout links
A checkout link for a specific plan now works for customers who already have a subscription. Choosing a different plan starts the same plan change as Switch Plan on the subscriptions page, and choosing the plan they already have takes them to that subscription. Pricing pages and emails can share one set of links for new and existing customers.
On the subscriptions page, customers can also delete a rolled API key that is still in its grace period, while the key that replaced it keeps working.
See Developer Portal monetization to set up the plugin and configure the pricing page.