Skip to main content

Credits System

Understand how credits work in Reeva.

What Are Credits?​

Credits are the currency for tool execution in Reeva. Each time a tool runs, credits are deducted from your balance.

How It Works​

Credit Costs​

Different tools cost different amounts:

Low Cost (1 credit):

  • Web Search (Google, DuckDuckGo)
  • Text utilities
  • Math operations
  • Database queries (simple)
  • Notion operations

Medium Cost (2-3 credits):

  • Firecrawl scraping
  • Perplexity AI search
  • Complex database operations
  • Apify actors

Higher Cost (5+ credits):

  • Large-scale web crawling
  • Batch operations
  • AI-heavy processing

Checking Costs​

In Dashboard:

  • Tools page shows cost per tool
  • Hover over tool for details

Via API:

GET /api/tools/costs

Returns:

{
  "google_search": 1,
  "firecrawl_scrape": 3,
  "perplexity_ask": 2,
  ...
}

Purchasing Credits​

One-Time Packages​

Buy credits as needed:

PackageCreditsPricePer Credit
Starter100$10$0.10
Growth500$40$0.08
Pro1,000$70$0.07
Enterprise5,000$300$0.06

Credits never expire!

Monthly Subscriptions​

Get recurring credits:

PlanCredits/MonthPricePer Credit
Basic500$35/mo$0.07
Professional2,000$120/mo$0.06
Business5,000$275/mo$0.055

Unused credits roll over!

Credit Usage​

Before Execution​

1. Tool call received
2. Check credit cost (e.g., 3 credits)
3. Check user balance (e.g., 100 credits)
4. Sufficient? → Proceed
5. Insufficient? → Block with error

Deduction Timing​

Credits are deducted before tool execution:

  • ✅ Prevents overuse
  • ✅ Fair for external API costs
  • ⚠️ Deducted even if tool fails (external API issue)

Tracking Usage​

Dashboard → Usage:

  • View all tool executions
  • See credits deducted
  • Filter by date, tool, server
  • Export usage reports

API:

GET /api/user/usage?start_date=2024-01-01&end_date=2024-01-31

Managing Credits​

Check Balance​

Dashboard: Top-right corner shows current balance

API:

GET /api/user/credits

Response:

{
  "current_credits": 847,
  "user_id": "user_abc123"
}

Purchase More​

Dashboard:

  1. Click credit balance
  2. Select package or subscription
  3. Complete checkout
  4. Credits added immediately

API:

POST /api/payments/create-checkout-session/credits
{
  "package": "growth",
  "success_url": "https://yourapp.com/success",
  "cancel_url": "https://yourapp.com/cancel"
}

Set Alerts​

Coming soon: Get notified when balance drops below threshold.

Credit Refunds​

When You Get Refunds​

  • ✅ Tool execution blocked by Reeva (e.g., server error)
  • ❌ External API failures (not Reeva's fault)
  • ❌ Invalid parameters (user error)

Requesting Refunds​

Contact support with:

  • Tool execution ID
  • Timestamp
  • Error details

Subscription Management​

Changing Plans​

Upgrade: Takes effect immediately, prorated charge
Downgrade: Takes effect next billing cycle
Cancel: Credits remain, no future charges

Billing Cycle​

  • Billed on same day each month
  • Credits added at start of cycle
  • Unused credits roll over
  • Subscription can be paused

Best Practices​

Optimize Usage​

  • ✅ Test tools in Playground before production
  • ✅ Use lower-cost tools when possible
  • ✅ Cache results when appropriate
  • ✅ Monitor usage patterns

Cost Management​

  • ✅ Set up usage dashboards
  • ✅ Review monthly reports
  • ✅ Optimize tool selection
  • ✅ Consider subscriptions for high volume

Avoid Waste​

  • ❌ Don't call tools unnecessarily
  • ❌ Avoid duplicate calls for same data
  • ❌ Don't use expensive tools for simple tasks
  • ❌ Test parameter validity before execution

FAQ​

Q: Do credits expire?
A: No! One-time purchase credits never expire.

Q: What if I run out mid-execution?
A: Tool won't execute. Add credits and retry.

Q: Can I get a refund for unused credits?
A: No, credits are non-refundable. But they never expire!

Q: Do subscription credits roll over?
A: Yes! Unused monthly credits accumulate.

Q: What happens if subscription lapses?
A: You keep existing credits. Just can't get new monthly credits until renewed.

See Also​