Skip to main content
Your Omnifence account uses prepaid credit. Each moderation request reduces your balance; when it reaches zero we reject new requests with 402 PAYMENT_REQUIRED until you top up.
Every new account starts with a free $1.00 credit so you can try the API before adding a payment method. It lands in your balance automatically when you sign up.
You can top up your account two ways:
  1. One-time top-up through the dashboard.
  2. Auto top-up, which automatically charges your saved card when your balance falls below a threshold you set.

​
One-time top-up

  1. Sign in to the dashboard and open Billing.
  2. Pick a preset amount (25to25 to 500) or enter a custom amount between 5and5 and 5000.
  3. Optionally check Save card for future top-ups if you want to reuse the same payment method later or enable auto top-up.
  4. Click Continue to checkout. You’re redirected to a Stripe Checkout page.
  5. Pay with your card. After Stripe confirms, you return to the dashboard and your balance updates.
Stripe processes the charge in your local currency where available (Adaptive Pricing). Your USD balance is always credited the amount you selected in step 2, regardless of the exchange rate applied at checkout.

​
Tax

If you have a billing address in a tax jurisdiction we collect from (e.g. EU VAT, certain US states), Stripe Tax adds the appropriate tax at checkout. Tax is collected and remitted by Stripe; it does not enter your prepaid balance. You can enter a business tax ID at checkout to apply reverse-charge rules where they apply.

​
Invoices

Top-ups paid through Stripe Checkout generate an invoice with a downloadable PDF. To find them, open Billing in the dashboard and click View invoices in the Billing history section. This opens the Stripe Customer Portal, where you can:
  • View and download invoices for past top-ups.
  • Add or remove saved cards.
  • Update your billing address and tax details.
Top-ups charged directly against a saved card appear in your billing history but do not produce a separate invoice document.

​
Saved payment methods

If you opted to save your card during a top-up, you can manage saved cards under Billing → Saved payment methods:
  • Add a card opens a zero-dollar Stripe Checkout that saves a card without charging it. Use it before you enable auto top-up.
  • Remove a card detaches the card from your account. If the removed card was the auto top-up default, auto top-up is automatically disabled.
We store only the card brand, last four digits, and expiry. Full PAN never touches our servers.

​
Auto top-up

Auto top-up charges your saved card off-session whenever your balance falls below a threshold you set. Configure it under Billing → Auto top-up:

​
Auto top-up terms

By enabling auto top-up you authorise us to charge your saved card off-session under these terms (also shown in the dashboard):
  • Frequency. Charges happen each time your balance falls below the threshold you set. There is no fixed cycle. The frequency depends on your usage.
  • Amount. Each charge is the “Top up by” amount, plus tax determined by your billing address.
  • Cancellation. Disable the toggle in the dashboard at any time. Charges already in flight will complete.
  • Failures. If a charge fails (declined card, SCA required, expired card, etc.), auto top-up is disabled with a structured reason. You can re-enable it after fixing the issue.

​
When auto top-up is disabled by the system

If we disable auto top-up automatically, the dashboard shows the reason:

​
Volume discounts

If your account qualifies for volume discounts, charges this calendar month are multiplied by a discount factor once your month-to-date spend crosses a threshold. The same tier set applies to both pricing methods (fixed and multiplier).
  • Threshold basis. Sum of charges billed since the start of the current UTC calendar month, in USD.
  • Forward-only. Discounts apply to future charges in the same month after the threshold is crossed. Past charges are not retroactively credited.
  • Tier resolution. The active tier is the one with the largest threshold that is at or below your current MTD spend. If no tier qualifies, your charges run at the un-discounted rate.
  • Per-account. Tiers are configured globally by default. If your account has custom tiers (or is opted out), your support contact can confirm what applies.
Each ledger row that was discounted records the volume-tier factor (e.g. 0.8000) and the base charge before the factor was applied, so discounted charges remain fully auditable in the dashboard’s billing ledger.

​
Attribution by API key

Every charge is attributed to the API key that submitted the job, not just to your account. The API key column in the dashboard’s billing history names that key, so you can see what each key costs you. For example, you can use one key per environment, customer, or service. Use the All API keys filter above the table to narrow the ledger to a single key. Rows produced without a job, such as top-ups, admin credits, and Stripe refunds, show no key. Job failure refunds keep the key from their job. Filter to rows with no key by selecting No API key. That option also covers any activity recorded before key attribution shipped. The column shows a key’s current name, so renaming a key updates it on every past row. A key you deleted keeps its rows: the ledger falls back to the key’s id, so past spend is never unattributed. The same column is on your job list, which is where you match a charge back to the work that caused it.

​
Refunds

To request a refund, contact support@omnifence.ai. Refunds reduce your prepaid balance by the refunded amount and return funds to the original payment method.

​
Dashboard only

You manage all billing from the dashboard: your balance, ledger, top-ups, saved cards, and auto top-up. There are no billing API endpoints; programmatic API keys can’t read your balance or usage, or move money. When a request is rejected with 402 PAYMENT_REQUIRED, sign in and top up.