Capability matrix

The full per-provider RevenueCapabilities reference for Polar, Lemon Squeezy, Stripe, Paddle, and Dodo Payments.

A complete reference of the RevenueCapabilities values each provider reports. Every provider exposes this object as capabilities, also surfaced on client.capabilities. The client gates on these values and throws unsupported rather than silently dropping an option — see Capabilities.

Matrix

Capability	Type	Polar	Lemon Squeezy	Stripe	Paddle	Dodo Payments
`cancellationReason`	`boolean`	`true`	`false`	`true`	`false`	`true`
`checkoutStatus`	`boolean`	`true`	`false`	`true`	`true`	`true`
`checkoutSuccessUrl`	`boolean`	`true`	`true`	`true`	`false`	`true`
`endTrial`	`boolean`	`true`	`true`	`true`	`true`	`false`
`hostedCheckout`	`boolean`	`true`	`true`	`true`	`false`	`true`
`listSubscriptionsByCustomer`	`boolean`	`true`	`false`	`true`	`true`	`true`
`portalReturnUrl`	`boolean`	`true`	`false`	`true`	`false`	`true`
`prorationBehaviors`	`ProrationBehavior[]`	`invoice_now`, `prorate`	`invoice_now`, `prorate`, `none`	`invoice_now`, `none`, `prorate`	`invoice_now`, `none`, `prorate`	`invoice_now`, `none`
`revoke`	`boolean`	`true`	`false`	`true`	`true`	`true`
`uncancel`	`boolean`	`true`	`true`	`true`	`true`	`true`

The in-memory provider from revenue-sdk/testing reports every capability true and all three proration behaviors, and accepts a Partial<RevenueCapabilities> override — see Testing provider.

What each field gates

PropType

cancellationReason?boolean

Whether subscriptions.cancel forwards reason/comment. Passing either without support throws unsupported.

Typeboolean

checkoutStatus?boolean

Whether Checkout.status is populated. When false, status is always null (Lemon Squeezy checkouts carry no lifecycle status).

Typeboolean

checkoutSuccessUrl?boolean

Whether checkouts.create accepts successUrl. Passing it without support throws unsupported (Paddle configures redirects in Paddle.js).

Typeboolean

endTrial?boolean

Whether subscriptions.endTrial is supported. Calling it without support throws unsupported.

Typeboolean

hostedCheckout?boolean

Whether checkouts.create returns a ready-to-use provider-hosted URL. When false (Paddle), the URL is your own Paddle.js page and needs a configured default payment link plus an approved domain.

Typeboolean

listSubscriptionsByCustomer?boolean

Whether subscriptions.list/listAll accept customerId. Passing it without support throws unsupported.

Typeboolean

portalReturnUrl?boolean

Whether customerPortal.createSession accepts returnUrl. Passing it without support throws unsupported.

Typeboolean

prorationBehaviors?('prorate' | 'invoice_now' | 'none')[]

Behaviors subscriptions.changePlan accepts. Any other value throws unsupported before the request.

Type('prorate' | 'invoice_now' | 'none')[]

revoke?boolean

Whether subscriptions.revoke (cancel immediately) is supported.

Typeboolean

uncancel?boolean

Whether subscriptions.uncancel can revert a scheduled cancellation.

Typeboolean

Beyond the capability object

Some limits are too fine-grained for a boolean and are enforced by the adapters, which throw RevenueError { code: 'unsupported' } at call time:

Limitation	Providers
Checkout item `quantity` must be `1`	Polar
Exactly one checkout item	Lemon Squeezy
`customerId` not accepted on a checkout (use `customerEmail`)	Lemon Squeezy
Plan-change `quantity` must be `1`	Polar, Lemon Squeezy
No customer portal until the customer has a subscription	Lemon Squeezy (`not_found`)

These gaps trace back to real differences between the underlying APIs — Stripe vs Polar vs Lemon Squeezy vs Paddle vs Dodo explains where each one comes from.

Reading capabilities at runtime

if (client.capabilities.revoke) {
  showRevokeButton();
}

const proration = client.capabilities.prorationBehaviors.includes('none') ? 'none' : 'prorate';

if (!client.capabilities.hostedCheckout) {
  // Paddle: render your own Paddle.js page instead of redirecting.
}

Status mapping

Subscription statuses across providers.

Capabilities concept

Why the SDK fails loud.