Getting started

Autlantic Billing verifies USDC subscriptions on Base. Funds settle to your EVM wallet (payoutAddressEvm). Autlantic does not custody member revenue.

Install

npm install @autlantic/payments-recurring@^0.2.7

Published packages (see Packages for versions):

• @autlantic/payments-recurring - main client (recommended)
• @autlantic/payments-recurring-core - types and billing rules
• @autlantic/chain-evm - Base + USDC adapter
• @autlantic/billing-engine - subscriptions and invoices

Source: github.com/autlantic/payments-sdk. Requires Node.js 20+.

Runnable example (one-time + recurring): examples/subscription-store.

Quickstart (sandbox)

activateSubscription completes the wallet mandate and charges the first open invoice. Do not call chargeInvoice on that same invoice afterward.

import { AutlanticBilling } from "@autlantic/payments-recurring";

const billing = AutlanticBilling.sandbox({ merchantId: "mer_demo" });

const { subscription } = await billing.createSubscription({
  merchantRef: order.id,
  customerWallet: member.walletAddress,
  payoutAddressEvm: creator.payoutAddressEvm,
  amountUsdc: 20,
  interval: "month",
});

const { charge } = await billing.activateSubscription(subscription.id);
if (charge?.invoice.status === "paid") {
  await markMembershipActive(order.id);
}

Hosted catalog (priceId)

With AUTLANTIC_BILLING_API_URL + API key, load products from the merchant portal catalog and subscribe by price:

const billing = AutlanticBilling.fromEnv();
const { products } = await billing.listProducts();
const priceId = products[0]?.prices[0]?.id;

const created = await billing.createSubscription({
  merchantRef: order.id,
  customerWallet: member.walletAddress,
  payoutAddressEvm: creator.payoutAddressEvm,
  priceId,
});
// created.checkoutUrl → hosted checkout (Connect wallet in the browser)

Use chargeInvoice later for renewals or after completeSubscription when you want mandate and charge as separate steps.

One-time payments

For a single USDC transfer (no mandate), use createPayment and hosted /checkout/pay/:id. See One-time payments.

const { payment, checkoutUrl } = await billing.createPayment({
  merchantRef: order.id,
  customerWallet: member.walletAddress,
  payoutAddressEvm: creator.payoutAddressEvm,
  amountUsdc: 49, // or priceId with interval "once"
});

Environment variables

Variable	Purpose
AUTLANTIC_BILLING_API_URL	Hosted billing API base URL (issued with your API key)
AUTLANTIC_BILLING_API_KEY	API key for authenticated routes
AUTLANTIC_BILLING_MERCHANT_ID	Default merchant id
AUTLANTIC_BILLING_SANDBOX	true / 1 for sandbox mode
AUTLANTIC_BILLING_WEBHOOK_SECRET	HMAC secret for x-autlantic-signature

const billing = AutlanticBilling.fromEnv();

For local demos without a remote API, use AutlanticBilling.sandbox() instead of fromEnv().

Hosted API alternative

If you prefer HTTP + API key over embedding Node, see Hosted HTTP API. Autlantic provides the base URL and credentials when you enable hosted billing.

Next steps

• Lifecycle (diagrams + activate vs renew)
• Error codes and Retries
• TypeScript types
• Sandbox & testing
• Webhooks
• Node.js API reference
• Changelog
• Security