---
title: "Generate subscription management link"
method: GET
path: "/v1/payments/subscription-management-link"
tags: ["Stripe Payments"]
---

# Generate subscription management link

`GET /v1/payments/subscription-management-link`

Generates a URL for the subscription management webview. Requires authentication. The URL includes a token that can be used to authenticate in the webview.

## Response `200`

Subscription management link generated successfully

- SubscriptionManagementLinkResponseDto
  - `url` string, required — URL for the subscription management webview
  - `expiresIn` number, required — Token expiration time in seconds
  - `subscription` SubscriptionInfoDto, required
    - `isSubscribed` boolean, required — Whether the user has an active subscription
    - `source` 'stripe' | 'apple' | 'funnelfox' | 'unlimit' | 'null', nullable, required — Subscription source (stripe, apple, funnelfox, unlimit, or null)
    - `planName` string, nullable, required — Subscription plan name
    - `status` string, nullable, required — Subscription status
    - `currentPeriodEnd` string, date-time, nullable, required — Current period end date
    - `cancelAtPeriodEnd` boolean, nullable, required — Whether subscription will cancel at period end
    - `email` string, nullable, required — User email
  - `provider` 'stripe' | 'apple' | 'funnelfox' | 'unlimit' | 'null', nullable, required — Payment provider (stripe, apple, funnelfox, unlimit, or null if no subscription)
  - `canManageOnline` boolean, required — Whether user can manage subscription via Stripe portal

## Other responses

- `401` — User not authenticated
- `404` — User not found or no Firebase account linked

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)