Billing

Pricing shape ruled D173 (2026-08-19), amended D174 (2026-08-20) — retires the Spark/Sprint/Mission/Deploy pack model in favor of rolling-30-day free floors plus per-action credit pricing and a volume-discount slider. GET /v1/capabilities is authoritative for numeric rates and tier copy.

Test mode. Billing currently runs on the Airwallex sandbox: checkout accepts test cards only and cannot take real payments yet. Credits granted in test mode are test money and carry a [SANDBOX] ledger note. This notice is removed when production billing is live.

Check status

GET /v1/billing
Authorization: Bearer ltx_your_key

Returns a snapshot of the authenticated agent:

Field	Meaning
`tier`	DB tier column (`spark`, legacy pack names, or `starter`/`pro` for older subscriptions)
`credits_remaining_usd`	Current spendable credit balance (USD string, 4 decimal places)
`credits_expire_at`	Legacy pack expiry for historical rows; purchased slider credits do not expire (D174)
`tier_label`	Human-readable tier name
`auto_topup`	`true` if auto top-up is configured
`over_limit`	`true` if storage, memory, or parse quota is at cap
`payment_processor`	Configured processor (`airwallex`)
`payment_customer_id`	Processor customer id when present
`recharge_consent_id`	Saved MIT consent for auto top-up
`memory_ops_this_month`	Memory operations logged this UTC month
`memory_storage_bytes`	KV JSON storage (bytes)
`blob_embed_storage_bytes`	Bytes used by parsed document chunk embeddings
`combined_memory_storage_bytes`	`memory_storage_bytes + blob_embed_storage_bytes`
`search_calls_this_month`	Web-discovery calls this UTC month
`browse_calls_this_month`	Browse calls this UTC month
`parse_ops_this_month` / `parse_ops_lifetime`	Parse usage

Free floors (D173/D174)

Before any credit is charged:

Action	Free floor	Window
Memory write	1,000	Rolling 30 days
Search	50	Rolling 30 days
Browse	20	Rolling 30 days

Past the floor: memory write 1 credit ( $0.01)**, search **2 credits ($ 0.02), browse static 3 credits ( $0.03)** / **dynamic 5 credits ($ 0.05). See Pricing for the volume-discount slider rates.

Buy credits (slider)

POST /v1/billing/credits/checkout
Authorization: Bearer ltx_your_key
Content-Type: application/json

{
  "credits": 2500
}

When Airwallex billing is configured on the host (AIRWALLEX_* credentials), returns 200 with intent_id, client_secret, billing_page_url (Split Card Elements on billing.lithtrix.ai), plus unit_rate_usd and total_usd at the D173 volume-discount table. Card data stays in the browser — Lithtrix creates the PaymentIntent server-side only. If billing is not configured yet, expect 503 with status: not_live and error_code: BILLING_NOT_CONFIGURED — honest pricing preview only, no charge.

Credits	Rate	Discount
1–999	$0.01/credit	base
1,000–4,999	$0.009/credit	10%
5,000–19,999	$0.0075/credit	25%
20,000+	$0.006/credit	40%

Purchased credit never expires (D174). Retired fixed packs used 180-day expiry on grant-only rows; slider purchases do not set expires_at.

Client config

GET /v1/billing/config

Returns payment_processor, publishable_key, billing_page_url, and js_env for Airwallex.js — no auth required.

Retired pack checkout

POST /v1/billing/packs/checkout returns 410 Gone (PACK_CHECKOUT_RETIRED). Fixed packs are historical only — use the slider endpoint above.

Save payment method (auto top-up)

POST /v1/billing/setup-intent
Authorization: Bearer ltx_your_key

Creates a zero-amount Airwallex PaymentIntent for card capture and unscheduled MIT consent. Complete payment on the billing page; payment_consent.verified webhook persists recharge_consent_id on your agent row.

Auto top-up

Set a threshold and credit amount — Lithtrix refills automatically when your balance drops below the threshold (merchant-initiated transaction using your saved consent).

POST /v1/billing/auto-topup
Authorization: Bearer ltx_your_key
Content-Type: application/json

{
  "enabled": true,
  "threshold_usd": "5.00",
  "credits": 2500
}

Requires a saved payment method and recharge_consent_id from the setup-intent flow above.

Webhook (ops)

POST /v1/billing/airwallex/webhook — Airwallex HMAC-signed events. Configure AIRWALLEX_WEBHOOK_SECRET on the host. Slider purchases grant on payment_intent.succeeded with metadata purchase_type=slider.

Environment (ops)

AIRWALLEX_CLIENT_ID, AIRWALLEX_API_KEY, AIRWALLEX_PUBLISHABLE_KEY, AIRWALLEX_WEBHOOK_SECRET
AIRWALLEX_BILLING_PAGE_ORIGIN — CORS origin for billing.lithtrix.ai

See also GET /v1/capabilities for the pricing block and per-call rates, and Pricing for the full D173/D174 shape.

Getting Started

API Reference

Concepts

Integrations

Check status

Free floors (D173/D174)

Buy credits (slider)

Client config

Retired pack checkout

Save payment method (auto top-up)

Auto top-up

Webhook (ops)

Environment (ops)

​Check status

​Free floors (D173/D174)

​Buy credits (slider)

​Client config

​Retired pack checkout

​Save payment method (auto top-up)

​Auto top-up

​Webhook (ops)

​Environment (ops)

Check status

Free floors (D173/D174)

Buy credits (slider)

Client config

Retired pack checkout

Save payment method (auto top-up)

Auto top-up

Webhook (ops)

Environment (ops)