Subscription Operations

The following Piano subscription management features are supported within the integration for Stripe managed subscriptions.

Update renewal payment method and billing address

The functionality to update payment method or billing address remains available and functions as it always has.

Changing payment method between Stripe and non-Stripe providers is supported via Piano's BYOP (Bring Your Own Processor) feature. See Non-Stripe Providers (BYOP) for full details.

Auto-renew toggle on/off

You can easily control whether a subscription renews automatically at the end of its term.

Turning Auto-Renewal OFF: When you disable auto-renewal, the system modifies the subscription billing plan to set a definitive end date: the end of the current paid period. This instructs the billing system not to generate any future invoices, ensuring the subscriber will not be charged again.

Turning Auto-Renewal ON: If you re-enable auto-renewal, the system removes that end date and restores the subscription's original, ongoing billing plan. The subscriber will be charged on their next scheduled billing date as if the setting was never changed.

Turning off auto-renewal during a grace period

When a subscriber turns off auto-renewal while their subscription is already in a grace period (a renewal payment failed and retry attempts are still running), the cancellation is deferred to the end of the current billing period. It does not take effect immediately.

Because the cancellation is deferred, payment retries continue for the open invoice throughout the remainder of the grace period. This means a retry can succeed after the subscriber has turned auto-renewal off. If the charge goes through and the subscriber did not intend it, it should be remediated with a refund.

This behavior applies to all subscriptions on Stripe Billing, both Stripe-native payment methods and BYOP integrations.

What happens step by step

1. A scheduled renewal payment fails. The subscription enters a grace period: access is retained while retries run.

2. During the grace period, the subscriber turns auto-renewal off.

3. The cancellation is scheduled for the end of the current billing period. The subscription is not cancelled immediately, and the open invoice is not voided.

4. Retries continue against the open invoice for the remainder of the grace period. If a retry succeeds, the payment is collected and the subscription is extended as normal, even though auto-renewal has been turned off. The deferred cancellation then takes effect at the next renewal date.

5. If the subscriber is charged unexpectedly, issue a refund.

The practical effect: turning auto-renewal off in a grace period stops future renewals but does not stop the in-flight retry of the currently failing payment.

BYOP note: BYOP subscriptions follow the same deferred-cancellation logic. The difference is that Piano drives the retries directly (rather than Stripe Smart Retries) and marks the invoice paid out-of-band on success.

Where the grace period is configured: grace period length is set per term under Manage → Terms. When Passive Churn Prevention is enabled, the length comes from a churn prevention logic under Management → Churn Prevention, which overrides term-level values with a 15-day default.

Your grace period settings continue to apply to BYOP subscriptions, because Piano still runs the retries. For Stripe-native subscriptions they are ignored: Stripe determines the retry schedule, and the grace period equals the billing period.

Immediate subscription cancellation

You can cancel a subscription at any time, with the cancellation taking effect immediately.

Cancellation without a Refund: This is a direct action. Our system sends a command to immediately terminate the subscription in the billing system. Access is revoked, and all future scheduled charges are stopped.

Cancellation with a Refund: This is a two-step process to ensure financial accuracy. Our refund process remains unchanged.

First, the refund is issued through the standard process.

Once the refund is successfully processed, the system then proceeds to cancel the subscription. This sequence prevents situations where a subscription is cancelled before a refund can be properly issued.

Refunds (full and partial)

Supported, refunds are automatically reflected in Stripe, for BYOP subscriptions invoice credit notes will also be applied to accurately adjust revenue recognition in Stripe.

Changing a Subscriber's Next Billing Date

You have the full flexibility to adjust when a subscriber is next charged, either to provide a complimentary service period or to align billing dates.

When you change a subscriber's next billing date in Piano, our system adjusts their billing schedule in Stripe. We effectively end their current paid period and insert a new, complimentary (zero-price) phase that runs from the moment of the change until the new billing date you've selected. Regular billing then resumes on that new date.

Important Caveat: Because Piano creates a complimentary period to bridge the gap, if you view the subscription directly in the Stripe dashboard, you might notice it temporarily reflects a $0 price until the new billing date arrives. This is the expected behavior.

Please note: currently changing the next billing date is only supported up to 3 years ahead. Stripe Price objects only support 3-year billing intervals as maximum at the moment due to risk and chargebacks typically associated with longer billing periods.

Manual Renewal

The core Manual renewal flow in MyAccount and Dashboard is supported for Stripe payment methods (Stripe Credit Cards, Stripe Elements sync, Stripe Apple Pay) and BYOP payment methods. This covers both pre-billing renewal and grace-period escape scenarios. Manual renewal for dynamic terms is planned for August 2026.

Upgrading and Downgrading

For more details on Upgrades, please see Subscription Upgrades. For deferred upgrades, publishers can manage the lifecycle with Suspend, Resume, Cancel, and Abort (automatic) operations.

Supported payment methods within the Stripe integrations

Stripe payment integrations (Stripe Credit Cards, Stripe Elements, Stripe Apple Pay) are fully supported as per documentation. Non-Stripe payment providers are supported via Piano's BYOP feature. See Non-Stripe Providers (BYOP) for configuration details.

Payment method management

Last updated: August 26, 2026