​

Billing → Payment: methods, subscription, tax, and outcome pricing

​

1. Payment method on file

1. Click Add payment method (empty state) or Update method (card on file). This opens the Stripe Customer Portal in a new tab.
2. In the portal, save a card or complete an ACH bank-add flow. Bank debits appear as the default method once they are approved.
3. Return to the dashboard. The card re-reads the method and shows the new brand and last four.

curl https://api.orbit.devotel.io/api/v1/billing/payment-method \
  -H "X-API-Key: $ORBIT_API_KEY"

// No typed payment-method helper in the SDK — plain fetch.
const res = await fetch(
  'https://api.orbit.devotel.io/api/v1/billing/payment-method',
  { headers: { 'X-API-Key': process.env.ORBIT_API_KEY! } },
);
const { data } = await res.json();
console.log(data.brand, data.last4, data.exp_month, data.exp_year);

import os, requests

r = requests.get(
    "https://api.orbit.devotel.io/api/v1/billing/payment-method",
    headers={"X-API-Key": os.environ["ORBIT_API_KEY"]},
)
body = r.json()["data"]
print(body.get("brand"), body.get("last4"))

{
  "data": {
    "brand": "visa",
    "last4": "4242",
    "exp_month": 12,
    "exp_year": 2028
  },
  "meta": {
    "request_id": "req_01HZY8EXAMPLE",
    "timestamp": "2026-09-08T11:21:18.901Z"
  }
}

​

2. Subscription card

{
  "data": {
    "status": "active",
    "cancel_at_period_end": false,
    "current_period_end": "2026-10-01T00:00:00.000Z"
  },
  "meta": {
    "request_id": "req_01HZY8EXAMPLE",
    "timestamp": "2026-09-08T11:21:18.901Z"
  }
}

• active — renews on current_period_end. The card shows the renewal date and a destructive Cancel subscription button.
• past_due — a renewal charge failed. Recover it by updating the payment method (section 1), then retrying the charge from the Stripe Customer Portal; the subscription returns to active once the invoice is paid. When dunning fails three consecutive times the account’s outbound sending pauses — restore it by getting a working card on file (see the Billing overview balance flags).
• Cancels at period end — you confirmed a cancel; the card swaps to a Reactivate action and shows the date access ends. Everything keeps working until current_period_end; the subscription simply does not renew.
• Canceled / no status — status is null and the card self-hides. Pay-as-you-go-only tenants (no subscription on file) always see the null branch, so useless cancel controls never render.

​

3. Tax info

• Jurisdiction is resolved by Stripe Tax. Orbit derives the applicable rate from your billing address (country + postal code) at invoice finalization. There is no in-app rate selector — the calculation is the provider’s, and the tile is read-only by design.
• Set a tax ID before the next invoice. Click Manage tax info to open the portal, where you update the billing address or add a business tax ID (VAT, GST, ABN, and the local equivalents). Changes apply to invoices issued after the update; they are never retroactive. EU B2B accounts with a verified VAT ID are reverse-charged automatically — the invoice shows a zero-VAT line instead of a charge.
• What shows on invoices. Each invoice carries the resolved tax jurisdiction, the applied rate, and the tax ID on file. Read them from Invoices, statements, and pay-by-link or GET /api/v1/billing/invoices.

​

4. Outcome-pricing section

• A toggle that arms outcome metering. Turning it ON opens a confirmation dialog — enabling a charge model is an explicit decision — before the config saves. Turning it OFF persists immediately and stops outcome charges from the next resolution.
• A default rate per outcome in USD, with sub-cent precision (the industry benchmark is $0.005). Rates are integer micro-cents on the wire (100 micro-cents =$0.0001) with a $10.00 per-outcome ceiling — the config is read on GET /api/v1/billing/outcome-pricing and written on the matching PUT (owner/admin/billing role, audit-logged).
• Per-outcome overrides — a mapping from outcome name (matched to the rubric name) to its own rate. Outcomes without an override use the default. Each key must be unique and 200 characters or fewer; the form validates before any PUT so a bad draft never reaches a 422.

​

Where next

• Billing overview — the whole wallet, plans, invoices, usage, and alerts map with API samples.
• Configure wallet auto-top-up — the rule that charges the payment method above when the balance crosses a threshold.
• Invoices, statements, and pay-by-link — where the tax ID resolved above actually appears.
• Billing API reference — request/response detail for every endpoint named here.