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.

JSONjson
{
  "isCustom": "true",
  "contactUrl": "sales@example.com",
  "contactLabel": "Talk to sales"
}

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.

tsx
zuploMonetizationPlugin({
  checkout: {
    renderBeforeCheckout: (props) =>
      props.plan.paymentRequired === false ? null : (
        <SubscribeQuestionnaire {...props} />
      ),
  },
});

No Stripe Checkout session exists until onComplete() fires, so customers who abandon the form don’t leave expired sessions behind.

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.