Plans

Plans define what your customers can subscribe to. Each plan maps to a provider plan.

Creating a Plan

1. Go to Plans in the sidebar
2. Click Create Plan
3. Fill in the details:

Plan Features

Define what features each plan includes by creating Entitlements:

// Example plan with features
{
  name: "Pro Plan",
  price: 5000, // ₦50
  features: {
    api_calls: { limit: 10000 },    // 10,000 API calls/month
    storage_gb: { limit: 50 },      // 50 GB storage
    team_members: { limit: 5 },     // Up to 5 team members
    premium_features: true,          // Boolean access
  }
}

Metered vs Feature Entitlements

Feature Entitlements (Boolean)

Simple on/off access to a capability:

await owo.check({ customer: "user_123", feature: "premium_features" });
// Returns: { allowed: true }

Metered Entitlements (Usage-based)

Track usage against a limit:

await owo.check({ customer: "user_123", feature: "api_calls" });
// Returns: { allowed: true, balance: 9500, limit: 10000 }

Updating Plans

When you update a plan:

• Price changes affect new subscribers only
• Feature changes affect all subscribers immediately

Syncing with providers

If you create plans directly in a provider dashboard:

1. Go to Plans → Sync from Provider
2. Owostack will import your existing plans
3. Configure features for each imported plan