Trial credits expiration — conflicting docs?

Thanks for flagging this, I can see why those two pages read as contradictory! They're actually describing two different states, but the subscriptions page doesn't make that clear enough. 

So, trial credits are non-expiring by default. The subscriptions docs are accurate for that default state:

Currency granted during a free trial does not expire when the trial ends, even if the customer cancels or chooses not to convert to a paid subscription. Customers will retain access to any virtual currency they received during the trial.

more context here

The expiring currencies page is describing what happens when you opt into expiration via the "Auto-expire at the end of billing cycle" toggle in the dashboard. When that toggle is on, it applies uniformly to both trial and normal billing periods:

Trials: Currency expires when the trial period ends Normal billing periods: Currency expires when the subscription billing cycle ends If the toggle is enabled, it applies to both trials and normal billing periods.

more context here

This to say that indeed, trial credits do not expire at all by default, regardless of whether the user cancels or converts. If you enable the toggle however, they will expire at the trial period end date, not on cancellation.

For your production environment, it will come down to your business goals! Leaving expiration off is the more conversion-friendly approacg, as users keep their trial credits. Enabling it makes sense if you're concerned about users repeatedly starting trials to accumulate currency without converting.

But neither is the "right" answer, as it depends on how generous you want the trial experience to be.

I'll pass this along to the team to tighten up the wording on the subscriptions page so the "by default" context is explicit and there's a clearer link between the two pages. Good catch and thanks for sharing!

Best,