> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.suby.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Subscriptions

> Charge customers on a recurring basis. Suby handles renewals, failed payment recovery, and cancellations automatically.

Subscriptions let you charge customers on a recurring basis. Suby handles the full lifecycle, renewals, failed payment recovery, and cancellations, automatically.

<Frame>
  <img src="https://mintcdn.com/suby/_7khuBgqYog1Ce4L/images/subscription.png?fit=max&auto=format&n=_7khuBgqYog1Ce4L&q=85&s=a2b71ff86497247f1c35319a556e082d" alt="Subscription" width="2384" height="1600" data-path="images/subscription.png" />
</Frame>

## How It Works

When a customer subscribes, Suby:

<Steps>
  <Step title="Processes the first payment">
    The first charge is collected immediately at checkout across the customer's chosen method, card, bank, Apple Pay, Google Pay, or stablecoin.
  </Step>

  <Step title="Calculates taxes">
    Applicable taxes are calculated and collected automatically based on the customer's location.
  </Step>

  <Step title="Delivers access">
    Access is granted based on your configured integration, PayLink, API, Discord, or Telegram.
  </Step>

  <Step title="Renews automatically">
    The subscription renews at the end of each billing cycle. Failed payments trigger dunning automatically.
  </Step>

  <Step title="Fires a webhook">
    A `subscription.created` event is sent to your server if you have a webhook configured.
  </Step>
</Steps>

## Use Cases

<CardGroup cols={2}>
  <Card title="SaaS & Tools" icon="rotate">
    Monthly or yearly access to software, APIs, or developer tools.
  </Card>

  <Card title="Discord Communities" icon="discord">
    Recurring access to paid Discord roles and private channels.
  </Card>

  <Card title="Telegram Groups" icon="paper-plane">
    Subscription-gated Telegram groups and channels.
  </Card>

  <Card title="Content & Newsletters" icon="newspaper">
    Paid newsletters, content libraries, and creator memberships.
  </Card>
</CardGroup>

## Billing Cycles

Suby supports any billing cycle, weekly, monthly, every 3 months, every 6 months, or yearly. You set it when creating your product.

## Dunning

If a renewal payment fails, Suby automatically retries the charge over the following days and notifies the customer to update their payment method. If the payment remains unresolved, the subscription is cancelled and access is revoked.

## Setting Up a Subscription

<Steps>
  <Step title="Create a product">
    Go to your dashboard and click **Create product**.
  </Step>

  <Step title="Set billing type">
    Select **Recurring** and choose a billing cycle.
  </Step>

  <Step title="Set your price">
    Enter your price in USD.
  </Step>

  <Step title="Choose your integration">
    Select PayLink, API, Discord, or Telegram.
  </Step>

  <Step title="Save and share">
    Your subscription is live instantly.
  </Step>
</Steps>

## Via API

<Card title="Full API Reference" icon="code" href="/v2/api-reference/subscriptions/get">
  Endpoints, parameters, and response objects for Checkout Sessions.
</Card>