---
title: "Monetization: Checkout and Plan Changes in the Developer Portal"
description: ""
canonicalUrl: "https://zuplo.com/changelog/2026/10/23/monetization-dev-portal-checkout"
pageType: "changelog"
date: "2026-10-23"
tags: "monetization, dev-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.

```json
{
  "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.

## 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](https://zuplo.com/docs/articles/monetization/developer-portal)
to set up the plugin and configure the pricing page.