We’ve migrated our documentation to a new site, which means some URLs have changed. If you hit a broken link, submit a support ticket.
Subscriptions

Stripe Billing

Overview

Stripe Billing is the billing engine behind Piano Subscriptions. Piano remains the front end for offers, terms, checkout and subscriber access, while Stripe handles invoicing, renewals, payment retries and revenue recovery. This section covers how the integration works, how to set it up, and how to run subscriptions once it is live.

Before you start

  • Piano Subscription Management + Billing, with Stripe Billing enabled on your account

  • A Stripe account, either created through Piano or connected from an existing Stripe organisation

  • An understanding of whether you process payments natively through Stripe (Stripe Payments) or through a non-Stripe processor (BYOP), because the setup and management paths differ

In This Section

Article

What it covers

Stripe Billing Integration

The technical reference. Full detail on configuration, features, billing operations, webhooks, reporting, data mapping and support. Start here when you need to know exactly how something behaves.

Stripe Billing Client Guides

A three-part walkthrough for clients: what the integration does, how to set it up, and how to manage subscriptions afterwards. Parts 2 and 3 come in a Stripe Payments and a BYOP version.

Billing periods and the 3-year guideline

Why Stripe limits billing intervals to three years, which terms are affected, and what to change.

  1. Read Part 1 of the Client Guides for what changes with Stripe Billing and which features are supported.

  2. Work through the Quick Start Guide that matches your setup, then Part 2 for the full setup and switch timeline.

  3. Use Part 3 for day-to-day subscription management, and the Stripe Billing Integration reference for anything it does not answer.

Last updated: