Billing & Credits

Purchase API credits at exact provider cost. We charge a 5% processing fee on purchases only — never on usage.

Passthrough Pricing

Unlike other API gateways, we don't mark up model costs. You pay exactly what providers charge. Our only fee is 5% on credit purchases (e.g., buy $10 worth → $0.50 fee → $9.50 in spend balance). Credits are priced at $0.001 each.

✅ Passthrough

You pay $0.00015 per 1K tokens for Gemini Flash — exact Google price

✅ Transparent

5% fee shown upfront on every purchase. No hidden margins.

✅ Fair

Failed calls aren't charged. Credits never expire.

GET
/v1/billing/packs
List available credit packs
POST
/v1/billing/checkout
Start a Stripe checkout session
GET
/v1/billing/history
View purchase history
GET
/v1/api-credits
Check API credit balance

List Credit Packs

No authentication required. Returns all available API credit packs.

Request

bash
1
"docs-token-command">curl https://theconflux.com/v1/billing/packs

Response

json
1
2
3
4
5
6
7
8
9
{
  "data": [
    { "key": "starter", "name": "API Starter", "price": "$9.99", "credits_after_fee": "~9,490", "note": "5% fee applied. 1 credit = $0.001" },
    { "key": "growth", "name": "API Growth", "price": "$24.99", "credits_after_fee": "~23,740", "note": "5% fee applied. 1 credit = $0.001" },
    { "key": "scale", "name": "API Scale", "price": "$49.99", "credits_after_fee": "~47,490", "note": "5% fee applied. 1 credit = $0.001" },
    { "key": "business", "name": "API Business", "price": "$99.99", "credits_after_fee": "~94,990", "note": "5% fee applied. 1 credit = $0.001" },
    { "key": "enterprise", "name": "API Enterprise", "price": "$199.99", "credits_after_fee": "~189,990", "note": "5% fee applied. 1 credit = $0.001" }
  ]
}

Start Checkout

Creates a Stripe Checkout session and returns a URL. Redirect your user to complete payment.

Body Parameters

ParameterTypeRequiredDescription
packstringYesOne of: starter, growth, scale, business, enterprise

Request

bash
1
2
3
4
"docs-token-command">curl -X "docs-token-keyword">POST https://theconflux.com/v1/billing/checkout \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"pack": "growth"}'

Response

json
1
2
3
{
  "url": "https://checkout.stripe.com/c/pay/cs_test_abc123..."
}

After payment, credits are added automatically via webhook. Redirect users back to your app with ?billing=success to show confirmation.

Purchase History

Request

bash
1
2
"docs-token-command">curl https://theconflux.com/v1/billing/history \
  -H "Authorization: Bearer YOUR_JWT"

Response

json
1
2
3
4
5
6
7
8
9
10
11
{
  "data": [
    {
      "id": "tx_abc123",
      "amount": "docs-token-number">15000,
      "balance_after": "docs-token-number">15000,
      "stripe_payment_id": "pi_3Oabc...",
      "created_at": "2026-03-30T10:00:00Z"
    }
  ]
}

Check API Credit Balance

Returns your API credit balance (separate from app credits). JWT auth only.

Request

bash
1
2
"docs-token-command">curl https://theconflux.com/v1/api-credits \
  -H "Authorization: Bearer YOUR_JWT"

Response

json
1
2
3
4
5
{
  "balance": "docs-token-number">14847,
  "total_purchased": "docs-token-number">15000,
  "total_consumed": "docs-token-number">153
}

Example Costs (Passthrough)

You pay exact provider cost. 1 API credit = $0.001. Costs shown per 1K tokens.

Model$/1K Input$/1K Output~Credits/1K In+Out
Gemini Flash$0.0001$0.0003~1
GPT-4o-mini$0.00015$0.0006~1
GPT-4.1-mini$0.0004$0.0016~2
Claude Sonnet$0.003$0.015~18
Claude Opus$0.015$0.075~90