PayVia Documentation

const user = await payvia.getUser();
// {
//   id: "user@gmail.com",
//   email: "user@gmail.com",
//   identitySource: "google",    // "google" or "random"
//   paid: true,                  // true if ACTIVE or TRIAL
//   status: "ACTIVE",            // "ACTIVE" | "TRIAL" | "INACTIVE"
//   planIds: ["plan-uuid-1"],
//   tier: { id: "tier-id", name: "Pro", level: 1, features: ["export_pdf", "api_access"] },
//   features: ["export_pdf", "api_access"],  // shortcut to tier.features
//   isTrial: false,
//   trialExpiresAt: null,        // Date object if on trial
//   daysRemaining: null,         // number if on trial
//   fromCache: false,            // true if returned from cache
//   checkedAt: 1709042400000,    // when license was last checked
//   ttl: 604800000,              // cache TTL in ms (7 days)
//   signature: "hmac-sig..."     // anti-tamper HMAC signature
// }

// Pricing mode (default) — shows all plans, user picks
await payvia.openPaymentPage({ mode: 'pricing', email: 'user@example.com' });

// Hosted mode — checkout for a specific plan
await payvia.openPaymentPage({ mode: 'hosted', planId: 'plan-uuid', email: 'user@example.com' });

// Direct mode — straight to PayPal (no PayVia UI)
await payvia.openPaymentPage({ mode: 'direct', planId: 'plan-uuid', email: 'user@example.com' });

const plans = await payvia.getPlans();
// [{ id: "plan-uuid", name: "Pro Monthly", price: 9.99, currency: "USD", interval: "Monthly", ... }]

const unsubscribe = payvia.onPaid((user) => {
  console.log('Payment successful!', user.tier.name);
  // Unlock features, show thank you, etc.
});

// Later: stop listening
unsubscribe();

await payvia.resetLicense();
// { message: "Reset complete. Deleted 2 subscription(s)." }

await payvia.cancelSubscription({
  planId: 'optional-plan-id',     // cancel specific plan, or omit for first active
  reason: 'User requested'       // optional reason
});
// { success: true, message: "Subscription canceled successfully", canceledPlanId: "plan-uuid" }

const identity = await payvia.getIdentity();
// { id: "user@gmail.com", email: "user@gmail.com", source: "google" }
// or: { id: "pv_a1b2c3d4-...", email: null, source: "random" }

if (await payvia.needsEmailForPayment()) {
  // Show email input field before checkout
  const email = prompt('Enter your email:');
  await payvia.openPaymentPage({ email });
} else {
  // Email auto-detected from Google identity
  await payvia.openPaymentPage();
}

// Check if user has Pro (level 1) or above
if (await payvia.hasTierLevel(1)) {
  showProFeatures();
}

if (await payvia.hasFeature('export_pdf')) {
  enableExportButton();
}

if (await payvia.hasFeature('api_access')) {
  showApiSection();
}

const tier = await payvia.getTier();
// { id: "tier-uuid", name: "Pro", level: 1, features: ["export_pdf", "api_access"] }
// or null if user has no active subscription

const trial = await payvia.startTrial();
if (trial) {
  console.log('Trial started!', trial.daysRemaining, 'days remaining');
  // { subscriptionId: "sub-uuid", status: "TRIAL", planId: "plan-uuid",
  //   planName: "Pro", trialExpiresAt: Date, daysRemaining: 14 }
}

const status = await payvia.getTrialStatus();
// { status: "TRIAL", trialExpiresAt: Date, daysRemaining: 12,
//   canConvert: true, planIds: ["plan-uuid"] }
// status can be: "TRIAL" | "ACTIVE" | "EXPIRED" | "NONE"

// Typical first-run flow: auto-start trial
const isFirst = await payvia.isFirstRun();
if (isFirst) {
  await payvia.startTrial();
  await payvia.markFirstRunDone();
}

await payvia.markFirstRunDone();

// In background.js (service worker)
chrome.runtime.onStartup.addListener(async () => {
  const payvia = PayVia('pv_live_xxx');
  await payvia.refreshLicenseCache();
});

// Force a fresh server check
const user = await payvia.refresh();
console.log('Fresh status:', user.status);

{
  "manifest_version": 3,
  "name": "My Extension",
  "version": "1.0.0",
  "permissions": ["storage", "identity", "identity.email"],
  "background": {
    "service_worker": "background.js"
  },
  "action": {
    "default_popup": "popup.html"
  }
}

import PayVia from './payvia.js';

const payvia = PayVia('pv_live_xxxxxxxx');

// Refresh license cache on browser startup
chrome.runtime.onStartup.addListener(async () => {
  await payvia.refreshLicenseCache();
});

// Refresh on extension install/update
chrome.runtime.onInstalled.addListener(async () => {
  await payvia.refreshLicenseCache();
});

import PayVia from './payvia.js';

const payvia = PayVia('pv_live_xxxxxxxx');

async function init() {
  // Auto-start trial on first run
  const isFirst = await payvia.isFirstRun();
  if (isFirst) {
    await payvia.startTrial();
    await payvia.markFirstRunDone();
  }

  // Get user status (uses cache, works offline)
  const user = await payvia.getUser();

  if (!user.paid) {
    // Show upgrade prompt
    showUpgradeUI();
    return;
  }

  // Show trial banner if applicable
  if (user.isTrial) {
    showTrialBanner(user.daysRemaining);
  }

  // Feature gating — check by tier level
  if (await payvia.hasTierLevel(1)) {  // Pro or above
    enableProFeatures();
  }

  // Feature gating — check by feature name
  if (await payvia.hasFeature('export_pdf')) {
    document.getElementById('export-btn').disabled = false;
  }
}

async function handleUpgrade() {
  // Check if we need to ask for email
  if (await payvia.needsEmailForPayment()) {
    const email = prompt('Enter your email for checkout:');
    if (email) {
      await payvia.openPaymentPage({ mode: 'pricing', email });
    }
  } else {
    await payvia.openPaymentPage({ mode: 'pricing' });
  }

  // Listen for payment completion
  payvia.onPaid((updatedUser) => {
    showThankYou();
    enableProFeatures();
  });
}

init();

import PayVia from './payvia.js';

const payvia = PayVia('pv_live_xxxxxxxx');

// In SaaS context, Chrome identity is unavailable.
// The SDK falls back to a random UUID stored in localStorage.
// You must provide the user's email for checkout.

async function onLogin(userEmail) {
  // Auto-start trial for new users
  const isFirst = await payvia.isFirstRun();
  if (isFirst) {
    await payvia.startTrial();
    await payvia.markFirstRunDone();
  }

  const user = await payvia.getUser();

  if (user.paid) {
    // Check tier access
    const tier = await payvia.getTier();
    console.log('User tier:', tier.name, 'Level:', tier.level);

    // Gate features
    if (await payvia.hasFeature('export_pdf')) {
      showExportButton();
    }

    if (user.isTrial) {
      showBanner(`Trial: ${user.daysRemaining} days remaining`);
    }
  } else {
    // Show pricing — email is required in SaaS context
    document.getElementById('upgrade-btn').onclick = () => {
      payvia.openPaymentPage({ mode: 'pricing', email: userEmail });
    };
  }
}

onLogin('user@example.com');