@frontal-labs/billing

Billing SDK for plans, subscriptions, invoices, usage metering, and payment methods.

Installation

bun add @frontal-labs/billing @frontal-labs/core

Usage

import { FrontalClient } from "@frontal-labs/core";
import { createBillingClient } from "@frontal-labs/billing";

const client = new FrontalClient({
  apiKey: process.env.FRONTAL_API_KEY!,
  baseUrl: process.env.FRONTAL_API_URL ?? "https://api.frontal.dev/v1",
});

const billing = createBillingClient(client);

// Resources: customers, plans, subscriptions, invoices, wallets, meters,
// prices, addons — each with list/create/get/update/delete/search + actions.
const customer = await billing.customers.create({ name: "Acme", externalId: "acme" });
const plans = await billing.plans.list();

const sub = await billing.subscriptions.create({
  customerId: customer.id,
  planId: plans.data[0].id,
});
await billing.subscriptions.cancel(sub.id);

const invoices = await billing.invoices.list();
const wallet = await billing.wallets.realTimeBalance("wal_123");

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | FRONTAL_API_KEY | Yes | — | Frontal API authentication key | | FRONTAL_API_URL | No | https://api.frontal.dev/v1 | Base URL for the Frontal API | | FRONTAL_ENV | No | development | Runtime environment (development, test, production) | | FRONTAL_DEBUG | No | false | Enable debug logging |