---
title: "Subscriptions"
description: "Tokenz Subscriptions — recurring billing, trial periods, dunning, and plan changes — are supported exclusively through the v2 API. The v1 Checkout Session..."
source: "https://docs.tokenz.one/en/v1/subscriptions"
api_version: "v1"
locale: "en"
version_status: "legacy"
docs_stage: "prod"
---

# Subscriptions

> **Subscriptions are available in API v2 only.** Switch to the [Subscriptions (API v2)](https://docs.tokenz.one/en/v2/subscriptions) documentation to integrate recurring billing.

Tokenz Subscriptions — recurring billing, trial periods, dunning, and plan changes — are supported exclusively through the **v2** API. The v1 Checkout Session and Webhook APIs do not include a `subscription` object, a `subscription` block on Checkout Session creation, or any `subscription.*` webhook events.

## Where to go instead

- [Subscriptions overview](https://docs.tokenz.one/en/v2/subscriptions) — what subscriptions are and how billing works
- [Integrate subscriptions](https://docs.tokenz.one/en/v2/subscriptions/get-started) — create a subscription checkout and activate it

## Using v1 and v2 together

You don't need to migrate your entire integration to use subscriptions. The v1 and v2 APIs run side by side under the same account and API key, so you can keep using v1 for your existing one-time-payment integration and call the v2 `/v2/checkoutsession` endpoint specifically for subscription checkouts.