Piano Stripe Billing Integration Guide - Overview

Overview

Piano's Stripe Billing integration combines Piano's flexible subscription management with Stripe's advanced billing infrastructure and AI-powered revenue recovery capabilities. This integration maintains Piano as your primary interface for subscription operations while leveraging Stripe's billing engine to handle payment processing, invoicing, and automated retry logic.

The Piano integration with Stripe is being released in phases.

Non-Stripe payment providers (BYOP — Bring Your Own Processor) are now supported. See Part 3: Manage Subscriptions with Stripe Billing for full details. This documentation will be updated as further enhancements are released.

This article provides a general overview of the Stripe Billing integration. For a complete breakdown of all configuration steps, supported features, and detailed implementation instructions, see Stripe Billing integration.

What's New with Stripe Billing

Enhanced Revenue Recovery

Your subscriptions now benefit from Stripe's AI-driven Smart Retries, which achieve 56%+ recovery rates on failed payments by:

• Learning from Stripe's network of billions of transactions (90% of cards have been seen on the Stripe network before)

• Timing retry attempts when payments are most likely to succeed

• Automatically optimizing retry strategies based on real-time signals

Improved Billing Date Management

Monthly and annual subscriptions now maintain their original billing dates even when adjusted for shorter months:

• Example: A subscription starting January 31st will bill on February 28th (or 29th), then return to March 31st

• Previously, the February 28th date would become the permanent billing date

Better Direct Debit Handling

Subscriptions using SEPA, BACS, or ACH payment methods now receive Smart Retry treatment, maintaining subscriber access during the retry period rather than immediately canceling.

Non-Stripe Processors Now Supported

Non-Stripe payment processors — including Braintree, Datatrans, and other PSPs — are now supported via the Bring Your Own Processor (BYOP) feature. Publishers can switch existing and new subscriptions to Stripe Billing while retaining their current payment processor. Stripe manages the subscription and invoice lifecycle; Piano handles payment collection through your PSP. See Part 3: Manage Subscriptions with Stripe Billing for full details.

Subscription Upgrades available

Subscription upgrades — moving a subscriber from one payment term to another — are now fully supported for all Stripe Billing managed subscriptions. All upgrade channels (My Account, Checkout, Publisher Dashboard, API, and Action Manager) use Stripe's subscription-first model: the plan change is applied immediately, and payment is collected after. Payment failure results in a grace period with Smart Retries — not a rollback. Publishers using MA/PD/API sync upgrade flows should review the Subscription Upgrades section in Part 3: Manage Subscriptions with Stripe Billing for more details.

Key Differences with Stripe Billing

Grace Period Behavior

Important Change: When using Stripe Billing with Smart Retries:

• Grace period length now equals your billing period (e.g., 1 month for monthly subscriptions)

• Retry timing is AI-driven rather than following a preset schedule

• A single renewal failure notification is sent instead of multiple notifications per retry

• Previous Passive Churn configurations no longer apply to Stripe-managed subscriptions

For BYOP subscriptions: the access extension trigger is invoice.finalized (not invoice.paid) — so access is extended when Stripe finalizes the renewal invoice, before payment is confirmed. Dunning and retry logic uses Piano's retry schedule (not Stripe Smart Retries) for BYOP methods. For BYOP async methods (direct debit, bank transfer), upgrade payment failures result in immediate cancellation without a grace period. See BYOP Upgrade Payment Failure Handling below.

Passive Churn vs Revenue Recovery (Smart Retries) Differences

Renewal Processing

Synchronous Payments (e.g. Cards):

1. Renewal date arrives

2. Payment attempt made immediately

3. If successful: subscription renewed, access continued

4. If failed: Smart Retry begins, access extended during retry period

Asynchronous Payments (e.g. Direct Debit):

1. Invoice created and finalized

2. Subscription renewed, access granted

3. Payment collection initiated

4. If payment fails: Smart Retry begins while maintaining access

Please note, that any single billing period — a billing plan, trial, access period — can run for up to 3 years. For more details, see Billing periods and the 3-year guideline.

Supported Features

New Purchases

• Single and recurring payment terms

• Free and paid trial periods

• Promotions and discounts

• Shared access subscriptions

• Stripe Cards, Elements, and Apple Pay

• Non-Stripe payment providers

• Gift purchases (creates Stripe Invoice with purchase-date service period)

Management + Billing

• Auto-renewal toggle

• Next billing date changes

• Immediate cancellation

• Payment method updates

• Billing address updates

• Full and partial refunds

• Immediate subscription upgrades (payment terms, same currency)

• Deferred (end-of-billing-cycle) subscription upgrades

• Pending upgrade cancellation, suspension, and resumption

• Manual renewal in MyAccount and Dashboard

Payment Methods and Countries

This section describes the payment methods and markets supported by the Piano Stripe Billing integration. The integration includes Stripe-native methods that are available immediately, BYOP (Bring Your Own Processor) integrations for clients using existing payment processors, and Piano-managed market support for select regions where Stripe does not offer direct merchant accounts.

Stripe-native payment methods

The following payment methods are available immediately through the Stripe-native integration:

Bring Your Own Processor (BYOP) integrations

With BYOP, Piano connects to your existing payment processor for charge collection while Stripe Billing manages the subscription schedule and invoicing. The following processors and connectors are supported:

Piano-managed markets

Features Coming Soon

The following features are not yet available with Stripe Billing but are planned for future releases:

• Manual subscription renewal in Checkout

• Dynamic terms functionality

• Future start dates

Last updated: July 03, 2026