Workspace settings

Workspace configuration APIs use an authenticated Usagey dashboard session and require organization admin access for mutations.

const response = await fetch(
  'https://usagey.com/api/billing/workspace?organizationId=org_123&env=sandbox',
  {
    method: 'POST',
    credentials: 'include',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({
      defaultCurrency: 'USD',
      supportedCurrencies: ['USD', 'EUR'],
      taxLabel: 'VAT',
      taxDefaultRate: 15,
      taxInclusive: false,
      issuerName: 'Acme Billing',
      supportEmail: '[email protected]',
    }),
  },
);

Keep revenue separated by currency. Usagey does not silently convert currencies or flatten mixed-currency revenue into one total.

V2 tax policy

Usagey uses manual tax configuration in V2. External tax calculation and registration determination are not performed. Operators are responsible for choosing the correct label, rate, registration ID, and inclusive or exclusive treatment for each workspace.

For manual transaction imports, omit taxAmount to calculate tax from the linked plan rate or the workspace default. If taxAmount is supplied, that amount is authoritative and treated as tax added to the supplied subtotal for backward compatibility. Usagey stores an immutable tax snapshot on the transaction so later workspace changes do not rewrite historical invoices or receipts.

Sandbox and Production settings are independent. Validate tax presentation in Sandbox, then configure Production explicitly; environment promotion does not replace live provider or compliance decisions.

The workspace invoice profile is reused across invoice PDFs, receipts, email delivery, and billing exports so customer-facing documents remain consistent.

V2 tax policy​

V2 tax policy