Skip to main content

Wallet and Billing

Buzzbin uses a prepaid wallet model. Every organization has an IRR wallet balance, and each review run consumes credit based on the actual model cost of that run.

The billing model at a glance

  • wallet balance is stored in IRR
  • top-ups are recorded directly in IRR
  • each run is first priced in USD
  • when the run executes, that USD cost is converted to IRR and deducted from the wallet

How the FX rate is chosen

Buzzbin reads the USD-to-IRR rate from market sources and uses a rate that keeps the converted IRR charge from falling below the real external USD compute cost.

That means:

  • a weaker IRR can make the same review cost more in IRR later
  • a previous top-up is not locked to a fixed USD amount

What you see on the Wallet page

  • Available: spendable credit
  • Balance: total wallet balance
  • Held: credit reserved for in-flight runs
  • Low balance: warning state
  • transaction history and transaction type

Transaction types

You may see entries such as:

  • TOP_UP
  • FREE_CREDIT
  • RUN_CHARGE
  • REFUND
  • ADMIN_ADJUSTMENT

For run charges, details like costUsd and fxRate are also stored so you can understand why credit was deducted.

What happens when balance is low

If available balance is not enough, Buzzbin does not start a new run. This keeps usage under control. When you are close to the warning threshold, the Wallet page shows the low-balance state.

Topping up your wallet

Wallet top-up is self-serve: any organization member can enter an amount on the Wallet page, complete payment through the payment gateway, and have the credit applied to the organization wallet automatically right after a successful payment.

What affects cost

  • the selected review and answer models
  • how many MRs are reviewed
  • which capabilities are enabled in review config
  • how many follow-up answers or repeated runs happen on a repository

If you want tighter control, review this page together with Configure reviews.