How do I verify purchases from a Node.js backend?

POST the purchase token to Tierux's REST API from your Node.js server using fetch or any HTTP client. Tierux verifies with Google Play or Apple and returns normalized entitlement state — your Node.js code gets back {active, entitlement, expiresAt} in one response.

Does Tierux have a TypeScript SDK or npm package?

Tierux's server-side integration is REST-first — plain HTTP calls, no SDK required. You can use fetch, axios, or any HTTP client. This keeps your backend dependency-light and works with any Node.js framework (Express, Fastify, Next.js API routes, etc.).

How do I check entitlements from TypeScript?

Call GET /api/v1/entitlements/{userId}/{entitlement} from your server with your API key. Tierux returns {active, entitlement, expiresAt, status, winbackPending} — gate any feature with a single TypeScript if statement.

TypeScript/Node Entitlements

Store your API key securely

Your Tierux API key is a server-side secret. Store it in environment variables — never in client code, never in a public repo.

// .env (never commit)
TIERUX_API_KEY=pe_live_xxxxxxxxxxxxxxxxxxxx

// config.ts
export const TIERUX_API_KEY = process.env.TIERUX_API_KEY!;
export const TIERUX_BASE = 'https://tierux.com/api';

Verify a purchase

After your app sends a purchase token to your backend, call Tierux to verify it server-side.

// verify-purchase.ts
export async function verifyGooglePlayPurchase(params: {
  appId: string;
  userId: string;
  packageName: string;
  productId: string;
  purchaseToken: string;
}) {
  const res = await fetch(
    `${TIERUX_BASE}/v1/purchases/google-play/verify`,
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${TIERUX_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(params),
    }
  );
  return res.json() as Promise<{
    ok: boolean;
    entitlement: string;
    active: boolean;
    expiresAt: string;
    status: string;
  }>;
}

Check an entitlement

Gate a feature by checking the user's entitlement state from your backend. One GET call — no caching, no state machine to maintain.

// check-entitlement.ts
export async function isEntitled(
  userId: string,
  entitlement: string
): Promise<boolean> {
  const res = await fetch(
    `${TIERUX_BASE}/v1/entitlements/${userId}/${entitlement}`,
    {
      headers: {
        'Authorization': `Bearer ${TIERUX_API_KEY}`,
      },
    }
  );
  const data = await res.json();
  return data.active === true;
}

Use with any Node.js framework

Tierux is framework-agnostic. Use it with Express, Fastify, Next.js API routes, or any other Node.js backend.

// Next.js API route example
export async function POST(request: Request) {
  const { purchaseToken, productId, userId } = await request.json();

  const result = await verifyGooglePlayPurchase({
    appId: 'app_123',
    userId,
    packageName: 'com.yourapp',
    productId,
    purchaseToken,
  });

  return Response.json({
    active: result.active,
    entitlement: result.entitlement,
    expiresAt: result.expiresAt,
  });
}

Apple verification too

For iOS purchases, send the StoreKit 2 JWS to the Apple verify endpoint. Same response shape, same entitlement logic.

// Apple verification
const res = await fetch(
  `${TIERUX_BASE}/v1/purchases/apple/verify`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${TIERUX_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      appId: 'app_123',
      userId,
      transactionId,
      jwsRepresentation,
    }),
  }
);

Related guides

TypeScript/Node entitlements

Store your API key securely

Verify a purchase

Check an entitlement

Use with any Node.js framework

Apple verification too

Server-side entitlements

Purchase verification

Quickstart docs

TypeScript/Node backend, verified in one call