useAppAccess

Check whether the authenticated end-user has access to a monetized built app, and open Stripe Checkout to unlock it. Use directly only for custom gate UI — AppPaywall wraps this with a default overlay.

import { useAppAccess } from 'flowstack-sdk/paywall'

Polls GET /billing/app-access/status every 60 seconds and exposes the access state plus a checkout() function that opens a Stripe Checkout session for a one-time unlock. 0.3.0 adds per-app subscriptions (P0-162): a subscription status block plus subscribe() / cancelSubscription() for the builder's monthly plan. Fails open on non-200 responses so a billing outage never locks users out client-side — the backend gate remains the enforcement boundary regardless of what this hook reports.

Most apps should render <AppPaywall siteId={config.appScope}> instead of consuming this hook directly; reach for useAppAccess when you need a custom paywall surface (pricing copy, metered-usage meter, custom CTA).

Signature

const { hasAccess, queriesUsed, queriesRemaining, paymentMode, unlockPriceCents, unlockPriceLabel, isLoading, error, checkout, refetch } = useAppAccess(siteId, opts?)

Parameters

Returns

Examples

import { useAppAccess } from 'flowstack-sdk/paywall';

function Gate({ children }: { children: React.ReactNode }) {
  const { hasAccess, queriesRemaining, unlockPriceLabel, isLoading, checkout } = useAppAccess(config.appScope);

  if (isLoading) return <p>Checking access…</p>;
  if (hasAccess) return <>{children}</>;
  return (
    <div>
      <p>{queriesRemaining === 0 ? 'Free queries used up.' : 'This app is premium.'}</p>
      <button onClick={() => checkout()}>Unlock for {unlockPriceLabel}</button>
    </div>
  );
}

See also

AppPaywall · setMonetization · getMonetization · PaymentRequired · AppSubscriptionStatus · subscribeToApp · cancelAppSubscription

Source: wallet/useAppAccess.ts · Also available in llms-full.txt and registry.json.