Subscriptions

Get subscription manage URL

Returns a signed, customer-facing self-service portal URL for the subscription, where the subscriber can view / cancel / resume it. The link is scoped to this one subscription; share it with the subscriber.

Authorization

AuthorizationRequiredBearer <token>

API key as Bearer token

In: header

Path Parameters

idRequiredstring

Subscription id, discoverable via list_subscriptions

GET/v1/subscriptions/{id}/manage-url

curl -X GET "https://api.3common.com/v1/subscriptions/string/manage-url" \
  -H "Authorization: Bearer <token>"

Default Response

Response

{
  "data": {
    "url": "string"
  }
}

TypeScript

export interface Response {
  data: {
    /**
     * Signed customer self-service portal URL for the subscription.
     */
    url: string;
  };
}

Update Subscription (mid-cycle change with proration)

Changes a subscription's priceId and/or quantity mid-cycle and issues a Stripe-style daily-prorated invoice for the rate difference. Allowed on active or trialing subs only (trialing skips proration entirely — the new price takes effect at trial end). The new price must be active, recurring, and the same currency as the current one. Downgrades that net <= 0 apply without generating a credit invoice (v1 has no credit balance — the customer simply pays less at next renewal).

Activate Subscription

Transitions an incomplete or trialing subscription to active. Wired to first-payment-succeeded events by the payment processor; also exposed for manual activation.