Billing

ShipOS billing eliminates the complexity of subscription management, handling everything from plan creation to dunning management with enterprise-grade reliability that scales with your business growth.

The billing system supports subscription-based, usage-based, and hybrid pricing models. Create unlimited plans with different features, pricing tiers, and billing cycles. The system automatically handles prorations, upgrades, downgrades, and cancellations without manual intervention.

Setting up your first subscription plan and subscribing users:

const plan = await shipos.billing.createPlan({
  name: 'Professional',
  price: 2999,
  interval: 'month',
  trialPeriodDays: 14
});

const subscription = await shipos.billing.createSubscription({
  userId: user.id,
  planId: plan.id
});

const plan = await shipos.billing.createPlan({
  name: 'Professional',
  price: 2999,
  interval: 'month',
  trialPeriodDays: 14
});

const subscription = await shipos.billing.createSubscription({
  userId: user.id,
  planId: plan.id
});

const plan = await shipos.billing.createPlan({
  name: 'Professional',
  price: 2999,
  interval: 'month',
  trialPeriodDays: 14
});

const subscription = await shipos.billing.createSubscription({
  userId: user.id,
  planId: plan.id
});

Payment processing supports all major credit cards, ACH transfers, and international payment methods out of the box. ShipOS handles PCI compliance automatically, storing only tokenized payment information while maintaining full transaction records for accounting and tax purposes.

The system includes automatic dunning management for failed payments. Configure retry schedules, grace periods, and automated email sequences. Users receive payment failure notifications with secure links to update their payment methods, reducing involuntary churn significantly.

Usage-based billing tracks and bills for actual consumption. Define usage metrics like API calls, storage, or custom events. The system aggregates usage data and generates accurate invoices automatically, supporting complex pricing models that grow with customer usage.