Documentation Index
Fetch the complete documentation index at: https://docs.stigg.io/llms.txt
Use this file to discover all available pages before exploring further.
Overview
The Stigg App for Stripe is a native Stripe UI Extension that surfaces real-time customer entitlement and subscription data directly inside the Stripe Dashboard without the need to switch between tools.
The app serves two audiences:
- New Stigg customers setting up a Stripe integration for the first time via OAuth — a read-only command center showing live entitlements, subscription status, and usage for any Stripe customer.
- Unlinked accounts: a gate screen that detects Stripe accounts not connected to Stigg and prompts the user to log in to Stigg.
The Stigg App for Stripe is currently only available for new accounts integrating with Stripe. It is not available for existing Stigg customers who already have a Stripe integration configured.
The Stigg App for Stripe is a viewer-only extension. It reads data from Stigg and does not create, update, or delete any entities in either Stigg or Stripe.
How it works
When a Stripe user opens the Stigg App drawer on a customer profile, the app authenticates silently using a Stripe-signed request without the manual login and resolves the customer through one of two paths:
| Scenario | Who sees it | What happens |
|---|
| Connected customer | Stripe accounts connected to Stigg through the app | The app looks up the Stripe account in Stigg and returns the Command Center immediately. |
| Unlinked account | Stripe accounts not yet connected to Stigg | The app returns the Gate view with a “Request Access” call-to-action. |
Installing the app
The Stigg App is installed as part of the Stripe integration setup in Stigg — there is no separate step required in the Stripe Marketplace.
- Follow the Stripe integration setup guide in Stigg Settings.
- During the OAuth authorization step, approve the install on your Stripe account. The Stigg App is automatically added to your Stripe Dashboard as part of this flow.
- Once connected, open any customer profile in the Stripe Dashboard and click the Stigg icon in the app drawer to see the Command Center.
The Command Center
Once your account is linked, opening the Stigg App drawer on any Stripe customer profile shows the Customer Details view.
Every tab displays a persistent header showing the customer’s name. If no name is set, the customer’s email address is shown instead; if neither is available, the header reads Unnamed Customer. A View in Stigg link next to the name opens the customer’s full profile in the Stigg app.
Subscriptions tab
Displays all subscriptions for the customer. Each item shows:
- Plan name and Subscription ID on two lines (e.g., “Basic” /
sub_1Abc…)
- Status pill — color-coded (green = Active, yellow = Pending, etc.)
Clicking a subscription opens the Subscription drawer.
Entitlements tab
The core view. Displays all entitlements derived from the customer’s active subscriptions.
Controls:
- Search bar — filter entitlements by name.
- Type filter — filter by entitlement type (metered, boolean, numeric, credits).
- Subscription filter — dropdown showing each subscription as Plan name + Subscription ID; filters entitlements to those granted by the selected subscription.
- Refresh — shows “Last refresh on [Date] [Time]” and a clickable refresh icon to pull the latest state from Stigg.
Entitlement types and icons:
Each entitlement row displays a type icon. Hovering the icon shows a tooltip:
| Type | Tooltip |
|---|
| Boolean feature | (no tooltip) |
| Metered feature (events) | Customer usage is determined by aggregation of reported events. Entitlement enforcement is near real-time. |
| Metered feature (usage) | Customer usage is determined by aggregation of reported events. Entitlement enforcement is near real-time. |
| Configuration feature (integer / string) | (no tooltip) |
| Credit entitlement | (no tooltip) |
- Feature name (e.g., “Active users”)
- Current usage vs. limit (e.g., “250 / 1,000 active users per month”)
- Source subscription name
- Progress bar — turns amber or red as the limit approaches
- Usage graph showing consumption over the relevant billing period; displays an empty state when no usage data is available
Boolean / static entitlements:
- Feature name (e.g., “Max file size”)
- Value (e.g., “5 MB” or enabled/disabled)
Credit entitlements:
- Credit type name
- Current balance vs. total granted credits
- Progress bar reflecting remaining balance
Subscription drawer
Clicking a subscription in the Subscriptions tab opens a drawer scoped to that subscription.
Overview
Displays the fields of the selected subscription in the same order as the Customer → Subscriptions tab:
| Field | Description |
|---|
| Plan name | Name of the plan |
| Subscription ID | Unique identifier of the subscription |
| Status | Active, Pending, etc. |
| Customer name / ID | Name or ID of the owning customer with a link to their profile |
| Created at | Subscription creation timestamp |
| Last updated | Most recent update timestamp |
Entitlements
Shows only the entitlements granted by this subscription — the same entitlement list and icons as the customer-level Entitlements tab, but pre-filtered to the selected subscription with no filter dropdown shown.
The Gate view
If the Stripe account is not linked to any Stigg workspace, the drawer displays the Gate view instead of the Command Center:
Manage entitlements with Stigg
See and control feature entitlements for every customer directly from their Stripe profile.
- Entitlements at a glance — See exactly which features and limits each customer is entitled to, per plan.
- Manage customer credits — Add credits, adjust balance, and track consumption without leaving the billing view in real time.
- Always in sync with Stripe — Plan changes in Stigg reflect instantly in Stripe. No manual reconciliation.
Clicking Connect Stigg initiates the connection flow.
Error and empty states
| State | What you see |
|---|
| Loading | Centered spinner with “Loading Data From Stigg” |
| Connection failed | ”App Failed to Load” message with a Retry button and a View in Stigg link. A correlation ID is shown to help with support. |
| Customer not found (404) | “Customer not found - Stripe customer not found in Stigg” with an option to View in Stigg |
| No entitlements | ”No active entitlements” empty state |
| No usage data (graph) | Empty state displayed inside the usage graph area |
