Skip to main content
To manually provision a subscription from the Stigg app:
  1. Click + Add under the Subscriptions section of the customer details screen.
  2. In the opened screen, enter the required details:

    ​
    Subscription content

    1. Product: Required when more than one product exists; otherwise preselected.
    2. Resource ID: The ID of the entity the subscription applies to (e.g., website ID, app ID). Used for products that allow multiple active subscriptions.
    3. Plan
    4. Billing period: Relevant for paid plans, such as monthly or annual.
    5. Plan configuration
    6. Add-ons: Select optional add-ons compatible with the chosen plan.

    ​
    Subscription start date

    1. Immediately: Default option.
    2. At the end of the current billing period: Applies if an active paid subscription already exists.
    3. Specific date: Allows backdated or future subscriptions.
      • Past start date → customer is billed starting next billing period.
      • Future start date → subscription becomes active on that date.

    ​
    Free trial

    • Applicable to paid and custom plans.
    • The plan’s default trial setting is preselected but can be overridden.

    ​
    Spend management for on-demand charges

    1. Minimum spend: Charged in advance; on-demand usage deducts from this amount. Overages appear on the next invoice. Can override plan defaults.
    2. Maximum spend: Enforces a hard stop when the usage limit is exceeded.

    ​
    Discounts

    • Discounts are applied via coupons.
    • Customizing a coupon creates an ad-hoc subscription-specific coupon that does not appear in the product catalog.

    ​
    Payment method

    1. Automatically use payment method on file: Required for paid plans.
    2. Generate an invoice: Useful for wire transfers or payment links. More details here.
    3. Don’t use Stigg for payments: Stigg manages entitlements only.

    ​
    Billing

    Available for paid plans when Stigg is integrated with a billing solution (Stripe, Zuora, or a custom billing provider).
    1. Billing anchor: Controls where the billing cycle is anchored for this subscription.
      • Unchanged (default): Keeps the existing billing cycle anchor.
      • Reset to now: Resets the billing cycle anchor to the current timestamp. Use this when upgrades or quantity increases should start a fresh billing period immediately.
    2. Proration: Determines how the financial impact of the subscription change is handled.
      • Prorate now: Generates and collects a prorated charge immediately.
      • Prorate + include in next invoice: Creates proration line items and defers the charge to the next billing cycle.
      • No proration: Disables proration entirely for this subscription.
    To configure billing anchor and proration programmatically when provisioning subscriptions via the SDK, pass the billingCycleAnchor property (SubscriptionBillingCycleAnchor.UNCHANGED or SubscriptionBillingCycleAnchor.NOW) and the subscriptionProrationBehavior property.
  3. Review the subscription summary.
  4. Click Create to provision the subscription.
  1. A customer can have at most one active trial and one active non-trial subscription per product.
  2. Provisioning a new trial cancels any existing trial for the same product at the new trial’s start date.
  3. Provisioning a new paid/non-trial subscription cancels the existing non-trial subscription at the new subscription’s start date.
  4. Upgrading from trial → paid starts the paid plan at the end of the trial.
  5. In self-served flows:
    • Customers get only one free trial per product.
    • Customers who have already paid for a plan are not eligible for another free trial.
    • Admins can override these limitations via the Stigg app.
To provision a paid subscription, the customer must have a valid payment method stored in the integrated billing solution.
Admins can add payment methods on behalf of customers when needed (e.g., during onboarding).
Payment methods are never stored in Stigg.
Stigg uses a generous entitlement model: when a customer has both a trial and an active subscription, whichever configuration or quota is more generous will take precedence.
You can determine the final entitlement results using the entitlement summary view.