Virtual Credits

products:
  - name: support_credits
    title: Support Credits
    description: Purchase support hours as credits
    behavior: credits
    config:
      credit_amount: 100  # Credits awarded per purchase
    prices:
      - name: default
        amount: 20000  # $200.00 in cents
        currency: usd

// After running ML inference
const requestCount = 100;
const creditsPerRequest = 0.2;
const totalCredits = requestCount * creditsPerRequest; // 20 credits

const response = await fetch(
  `/v1beta1/organizations/${orgId}/billing/${billingId}/usages`,
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${token}`
    },
    body: JSON.stringify({
      amount: totalCredits,
      source: 'ml_inference',
      description: `GPT-4 inference - ${requestCount} requests`,
      user_id: userId,
      metadata: {
        model: 'gpt-4',
        requests: requestCount.toString(),
        tokens_used: '5000'
      }
    })
  }
);

if (!response.ok) {
  if (response.status === 402) {
    // Insufficient credits - prompt user to purchase more
    showPurchaseCreditsModal();
  }
}

curl -X POST 'https://frontier.example.com/v1beta1/organizations/{org_id}/billing/{billing_id}/usages/{usage_id}/revert' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <token>' \
  -d '{
    "amount": 10
  }'

curl -X POST 'https://frontier.example.com/v1beta1/organizations/{org_id}/billing/{billing_id}/credits' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <admin_token>' \
  -d '{
    "amount": 50,
    "source": "system.awarded",
    "description": "Promotional credits for new customer",
    "metadata": {
      "promotion": "LAUNCH2024"
    }
  }'

billing:
  customer:
    onboard_credits_with_org: 100

plans:
  - name: starter_monthly
    on_start_credits: 50
    products:
      - name: starter_access

Balance = Sum(Credit Transactions) - Sum(Debit Transactions)

const balance = await getBalance(customerId);
const threshold = 50; // Warn when below 50 credits

if (balance.amount < threshold) {
  await sendEmail(customer.email, {
    subject: 'Low Credit Balance',
    body: `You have ${balance.amount} credits remaining. Purchase more to continue using the service.`
  });
}

SELECT 
  source,
  SUM(amount) as total_credits,
  COUNT(*) as usage_count,
  AVG(amount) as avg_per_usage
FROM transactions
WHERE 
  customer_id = 'cus_123'
  AND type = 'debit'
  AND created_at >= NOW() - INTERVAL '30 days'
GROUP BY source;