Subscription wall guide

import { ArcenClient } from "@arcenpay/node";

const client = new ArcenClient({
  apiKey: process.env.ARCENPAY_API_KEY!,
});

export async function checkAccess(companyId: string, featureKey: string) {
  const entitlement = await client.checkEntitlement(featureKey, {
    id: companyId,
  });

  if (!entitlement.enabled) {
    throw new Error("Upgrade required");
  }

  return entitlement;
}

import { NextRequest, NextResponse } from "next/server";

export async function middleware(request: NextRequest) {
  const companyId = request.cookies.get("company_id")?.value;
  if (!companyId) return NextResponse.redirect(new URL("/login", request.url));

  const entitlement = await client.checkEntitlement("scan", { id: companyId });
  if (!entitlement.enabled) {
    return NextResponse.redirect(new URL("/billing?upgrade=required", request.url));
  }

  return NextResponse.next();
}

"use client";

import { useFlag, useEntitlement, ArcenEmbed, FeatureFlagGuard } from "@arcenpay/react";

export function ScanPage() {
  const hasAccess = useFlag("scan");
  const entitlement = useEntitlement("0x...", "scan");

  if (!hasAccess) {
    return (
      <div className="p-8 text-center">
        <h1>Upgrade to access scans</h1>
        <p>You are currently on {entitlement.plan}. Upgrade to unlock this feature.</p>
        <ArcenEmbed mode="modal" initialView="checkout" />
      </div>
    );
  }

  return <Scanner />;
}

import { FeatureFlagGuard } from "@arcenpay/react";

<FeatureFlagGuard featureKey="export_pdf" walletAddress={walletAddress}>
  <ExportButton />
</FeatureFlagGuard>

const company = await client.getCompany("cm_abc123");
// company.entitlements contains all resolved features
const canScan = company.entitlements.some(e => e.featureKey === "scan" && e.value === "1");

import { useState } from "react";
import { ArcenEmbed } from "@arcenpay/react";

const [showCheckout, setShowCheckout] = useState(false);

// ...render the wall with a CTA:
<button onClick={() => setShowCheckout(true)}>Upgrade to continue</button>

{showCheckout && (
  <ArcenEmbed
    mode="modal"
    initialView="checkout"
    onViewChange={(view) => {
      if (view === "success") {
        setShowCheckout(false);
        window.location.reload();
      }
    }}
  />
)}

const result = await client.consumeEntitlement({
  featureKey: "scan",
  company: { id: companyId },
  idempotencyKey: `scan-${requestId}`,
});

if (result.exceeded) {
  throw new Error("Usage limit exceeded. Upgrade your plan.");
}