newOS for Developers

Paywall & Credits

Subscription management, Stripe integration, and credit operations

📚 Related newOS Documentation

payment.ts Actions user.ts Subscription UserReadPrivateResponse Stripe Webhooks

Subscription Status Fields

Available on UserReadPrivateResponse (current user only)

// Private user subscription fields
{
  isPro: boolean;              // Has active Pro subscription
  proLevel: number;            // Pro tier level (1, 2, 3)
  subscriptionLevel: string;   // "free" | "pro" | "enterprise"
  subscriptionStatus: string;  // "active" | "canceled" | "past_due"
  subscriptionExpiry: string;  // ISO date string
  stripeUid: string;           // Stripe customer ID
  watts: number;               // Engagement credits balance
}

// Check subscription status:
// See /actions/user#current for implementation

Available Skills

Subscription Check action docs

beginner

Verify Pro status and subscription level

GET /user/current

Stripe Payment Intent action docs

intermediate

Create payment intent for one-time purchases

POST /payment/stripe/intent

Subscription Payment action docs

intermediate

Set up recurring billing for Pro access

POST /payment/stripe/subscription/payment

Claim Watts action docs

beginner

Claim engagement credits from activity

POST /user/claimWatts

Stake User action docs

intermediate

Power stake to support creators

POST /user/stake

Subscription Payment Flow

Full implementation in payment.ts → subscribe()

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Stripe.js      │ ──▶ │  Payment Method │ ──▶ │  POST /payment/ │
│  Card Element   │     │  (tokenized)    │     │  stripe/sub...  │
└─────────────────┘     └─────────────────┘     └────────┬────────┘
                                                         │
┌─────────────────┐     ┌─────────────────┐     ┌────────▼────────┐
│  UI Update      │ ◀── │  user.current() │ ◀── │  Webhook        │
│  isPro: true    │     │  refresh        │     │  subscription   │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Related Hubs

Account (profile)Moods (paywall)