stigg

Capabilities

Stigg is a comprehensive pricing and packaging orchestration platform that enables agents to:

• Define and manage product pricing models – Create flexible pricing strategies including freemium, free trials, usage-based, hybrid, and custom pricing
• Manage customer subscriptions and entitlements – Provision customers, create subscriptions, manage upgrades/downgrades, and control feature access
• Track and meter usage – Report usage metrics for metered features with real-time tracking and aggregation
• Manage credits and prepaid models – Grant, track, and consume credits with automatic deductions based on usage
• Render monetization UI components – Deploy pricing tables, customer portals, checkout flows, and credit management widgets
• Automate monetization workflows – Create custom workflows triggered by events with conditional logic and integrations
• Integrate with billing and CRM systems – Sync data with Stripe, Zuora, Salesforce, HubSpot, and other platforms
• Analyze pricing and subscription data – Access dashboards, experiments, and analytics for pricing optimization

Skills

Customer Management

• Provision customers – Create customers with provisionCustomer mutation, including name, email, billing information, and optional initial subscription
• Update customer details – Modify customer information and metadata using updateCustomer
• Archive customers – Soft-delete customers while preserving billing history with archiveCustomer
• Retrieve customer data – Query customer details, subscriptions, entitlements, and promotional grants with getCustomer or listCustomers
• Apply coupons – Assign discount coupons to customers using setCouponOnCustomer

Subscription Management

• Create subscriptions – Provision subscriptions with createSubscription specifying plan, billing period, add-ons, and start date
• Update subscriptions – Modify active subscriptions with updateSubscription to change plans, add-ons, or feature quantities
• Cancel subscriptions – End subscriptions with cancelSubscription with optional cancellation reasons
• Estimate subscription costs – Preview pricing with estimateSubscription including proration calculations
• Migrate subscriptions – Update subscriptions to latest plan versions with migrateSubscriptionToLatest
• List subscriptions – Query subscriptions with filtering by customer, status, or plan using listSubscriptions
• Get subscription details – Retrieve full subscription information including pricing, add-ons, and invoice status

Entitlements and Feature Access

• Check feature entitlements – Query entitlement to verify if a customer has access to a specific feature with usage limits
• Get all entitlements – Retrieve entitlementsState to see all features a customer is entitled to with current usage and limits
• Grant promotional entitlements – Award temporary feature access using grantPromotionalEntitlements with optional expiration
• Revoke promotional entitlements – Remove promotional access with revokePromotionalEntitlement
• Recalculate entitlements – Trigger entitlement recalculation with recalculateEntitlements after subscription changes

Usage Tracking and Metering

• Report usage – Submit usage measurements with reportUsage for metered features (calculated usage)
• Report raw events – Ingest raw events with reportEvent for Stigg to aggregate (e.g., MAU tracking)
• Bulk report usage – Submit multiple usage records with reportUsageBulk for efficiency
• Query usage history – Retrieve historical usage data with usageHistory for auditing and analytics
• View usage events – Access raw event logs with usageEvents for debugging and verification

Credit Management

• Create credit grants – Award credits to customers with createCreditGrant specifying amount, currency, and expiration
• Void credit grants – Revoke unused credits with voidCreditGrant
• Query credit balance – Check current credit balance with creditBalance for a specific currency
• View credit ledger – Access complete credit transaction history with creditLedger for reconciliation
• List credit grants – Retrieve all active and expired grants with creditGrants

Pricing and Plans

• Create plans – Define plans with createPlan including pricing, billing period, features, and trial configuration
• Create add-ons – Build supplementary offerings with createAddon for additional revenue
• Publish plans – Release plan versions with publishPlan to make them available to customers
• List plans – Query available plans with listPlans with filtering options
• Get plan details – Retrieve full plan information including pricing, features, and metadata
• List add-ons – Query available add-ons with listAddons
• Set package pricing – Configure pricing for custom plans with setPackagePricing

Features and Feature Groups

• Create features – Define feature types (boolean, metered, configuration, enum) with createFeature
• Update features – Modify feature details and metadata with updateFeature
• Archive features – Retire features with archiveFeature while preserving history
• List features – Query all features with listFeatures
• Create feature groups – Organize features with createFeatureGroup for better UX
• Update feature groups – Modify group membership and metadata

Coupons and Discounts

• Create coupons – Define discount codes with createCoupon (percentage or fixed amount)
• Apply coupons – Assign coupons to customers or subscriptions
• List coupons – Query available coupons with listCoupons
• Archive coupons – Retire coupons with archiveCoupon

Pricing Tables and Widgets

• Render pricing table – Display plans with Paywall component showing features and pricing
• Render customer portal – Show subscription management UI with CustomerPortal widget
• Render checkout – Embed payment flow with Checkout component
• Display credit balance – Show customer credits with CreditBalance widget
• Display credit usage – Visualize credit consumption with CreditUsage chart
• Display credit grants – List active grants with CreditGrants table
• Configure auto-recharge – Enable automatic credit top-ups with CreditAutoRechargeConfiguration

Workflow Automation

• Create workflows – Build automation with visual workflow builder using triggers, conditions, and actions
• Trigger workflows – Workflows respond to events like subscription changes, usage thresholds, trial expiration
• Conditional logic – Implement branching with conditions based on customer data, usage, or subscription state
• Execute actions – Perform operations like granting entitlements, sending notifications, or calling webhooks
• Manage credentials – Store and use API keys for integrated services within workflows
• Monitor execution – Track workflow runs with execution history and activity logs

Webhooks and Events

• Subscribe to events – Receive webhooks for subscription changes, usage updates, entitlement changes, credit balance updates
• Handle events – Process events like subscriptionCreated, subscriptionCanceled, entitlementUsageExceeded, creditBalanceLow
• Integrate with services – Forward events to Segment, Zapier, or custom endpoints
• Retry logic – Automatic retry handling for failed webhook deliveries

Data Integration

• Import customers – Bulk import existing customers from CSV
• Import subscriptions – Migrate subscription data from legacy systems
• Import usage – Load historical usage data for metered features
• Export to data warehouses – Sync data to Snowflake or BigQuery for analytics
• Integrate with Stripe – Sync subscriptions and billing with Stripe
• Integrate with Zuora – Connect to Zuora for enterprise billing
• Integrate with Salesforce – Sync customer and subscription data with Salesforce
• Integrate with HubSpot – Sync contacts and create automation flows
• AWS Marketplace – List products on AWS Marketplace with automatic provisioning

SDKs and API Access

• GraphQL API – Access comprehensive API at https://api.stigg.io/graphql with queries, mutations, and subscriptions
• Backend SDKs – Use SDKs for Node.js, Python, Go, Ruby, Java, .NET, or Sidecar
• Frontend SDKs – Integrate with JavaScript, React, Vue.js, or Next.js
• REST API – Access REST endpoints (private beta) for alternative integration
• Real-time subscriptions – Subscribe to real-time updates for entitlements, usage, credits, and package changes
• Rate limiting – Standard tier: 1,000 requests/minute; Enterprise: custom limits

Analytics and Insights

• Dashboard – View subscription metrics, MRR, churn, and customer insights
• Active subscriptions dashboard – Monitor subscription status and lifecycle
• Feature inspector – Analyze feature adoption and entitlement distribution
• Experiments – A/B test pricing changes with statistical significance
• Price localization – Configure region-specific pricing with automatic currency conversion

Workflows

Provision a New Customer with Subscription

1. Call provisionCustomer with customer details and optional subscriptionParams
2. Specify plan ID and billing period in subscription parameters
3. Optionally apply coupon at customer creation
4. Receive customer ID and initial subscription details
5. Sync customer to billing provider if integrated

Implement Usage-Based Pricing

1. Create metered features with createFeature (type: METERED)
2. Assign features to plans with usage limits
3. Report usage with reportUsage or reportEvent as customers consume
4. Query entitlement to check current usage against limits
5. Trigger workflows on usage thresholds to notify or auto-upgrade customers

Manage Subscription Upgrades and Downgrades

1. Query current subscription with getSubscription
2. Estimate new cost with estimateSubscription for target plan
3. Call updateSubscription with new plan ID
4. Receive proration details (credit or debit)
5. Handle payment if required via billing provider

Grant and Track Credits

1. Create credit grant with createCreditGrant specifying amount and expiration
2. Report usage that consumes credits with reportUsage
3. Query creditBalance to show customer remaining credits
4. Monitor creditBalanceLow webhook events for auto-recharge triggers
5. Access creditLedger for audit trail and reconciliation

Automate Trial Extension Based on Usage

1. Create workflow triggered by entitlementUsageExceeded event
2. Add condition checking if customer is in trial period
3. Add action to grant promotional entitlement extending trial
4. Optionally notify customer of extension
5. Monitor workflow execution history for success/failure

Render Pricing and Enable Self-Service

1. Integrate Paywall component with product ID
2. Configure styling with no-code widget designer
3. Handle onPlanSelected callback to create subscription
4. Embed CustomerPortal for subscription management
5. Use Checkout component for payment collection
6. Widgets auto-sync with pricing changes in Stigg

Integration

Stigg integrates with:

• Billing: Stripe, Zuora, multiple providers simultaneously
• CRM: Salesforce, HubSpot with bidirectional sync
• Data Warehouses: Snowflake, BigQuery for analytics
• Marketplaces: AWS Marketplace for SaaS listings
• Authentication: Auth0 for identity management
• Automation: Zapier, Segment for event forwarding
• Custom: Webhooks to any HTTP endpoint

All integrations are environment-specific, allowing testing before production deployment.

Context

Key Concepts:

• Products – Top-level offering that groups plans and defines subscription rules
• Plans – Pricing templates (free, paid, custom) with features and billing terms
• Add-ons – Supplementary offerings that extend plans with additional features
• Features – Discrete capabilities assigned to plans/add-ons (boolean, metered, configuration, enum)
• Entitlements – Actual permissions granted to customers based on their subscription
• Subscriptions – Customer’s active plan with billing status and feature access
• Credits – Custom currency units for prepaid and usage-based pricing models
• Environments – Isolated workspaces (dev, staging, production) with separate data and API keys

Pricing Models Supported:

• Freemium with limited features
• Free trials with optional paid conversion
• Fixed recurring billing (monthly, annual)
• Usage-based with per-unit charges
• Hybrid combining fixed + usage charges
• Prepaid credits with consumption
• Custom negotiated pricing per customer
• Overages for exceeding limits

Feature Types:

• Boolean: Simple on/off access
• Metered: Tracked usage with limits (incremental or fluctuating)
• Configuration: Numeric values (seats, storage, etc.)
• Enum: Predefined option sets

Entitlement Behavior:

• Additive: Multiple sources (plan + add-ons) sum together
• Multiplicative: Add-on quantities multiply entitlements
• Usage reset periods: Daily, weekly, monthly, annual
• Fallback strategies: Graceful degradation when service unavailable
• Caching: Local caching with fallback for high availability

For additional documentation and navigation, see: https://docs.stigg.io/llms.txt