Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.omnifence.ai/llms.txt

Use this file to discover all available pages before exploring further.

Your Stars 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. 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 (25–25 – 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. Useful before enabling 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:
SettingWhat it does
Trigger when balance falls belowWhen this is 5, an auto top-up fires the next time your balance drops under $5.
Top up byThe USD amount to charge. Must be greater than the trigger threshold.
Payment methodWhich saved card to charge.

​
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 — 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:
ReasonWhat happenedWhat to do
authentication_requiredYour card issuer required 3-D Secure authentication, which can’t happen off-session.Re-authenticate by initiating a fresh one-time top-up, then re-enable.
card_declinedStripe declined the charge.Check the card, update it in Saved payment methods, then re-enable.
payment_method_detachedThe saved card was removed (from this dashboard or via Stripe).Add a new card and re-enable.
tax_address_requiredWe need a billing address to calculate tax, but the card on file has none.Run a fresh one-time top-up in Checkout to refresh your billing address, then re-enable.
stripe_errorStripe returned an unexpected error.Contact support.

​
Refunds

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

​
API access

If you’d rather drive top-ups programmatically, see the Billing API endpoints: These endpoints require the billing:write scope. The dashboard session has this scope by default; for programmatic API keys you must request it explicitly when issuing the key.