Skip to main content

Custom Credits

Buy Credits à la carte outside the subscription cycle via the Top-Up Credits page.

Find it at: /top-up-credits.

Top-Up Credits page


1. What Custom Credits are

Custom Credits are a one-time Credits purchase that lands as Recharge Credits in your balance. Unlike Monthly Credits (which refresh and expire each billing cycle), Recharge Credits roll over indefinitely — they stay until you spend them.

Three things to know about how they sit in your wallet:

  • They count toward your overall Credits balance — the same one shown on /account/usage.
  • They're the last bucket consumed (deduction order: Limited-time → Monthly → Recharge), so they act as a long-term reserve.
  • They never expire on a fixed date.

See /reference/credits-system for the full Credits model.

warning

Custom Credits are restricted to Base / Pro / Elite subscribers. Free users will hit a paywall pointing back to /account/subscribe.


2. How to purchase

  1. Open /top-up-credits.
  2. Pick a quick amount ($20 / $100 / $500) or type a custom amount in USD.
  3. The page live-quotes how many Credits you'll receive, the per-credit rate, and any next-tier upsell.
  4. Click Pay — Alphio creates a checkout session and redirects you to the PSP-hosted page.
  5. After payment, Credits are credited automatically once the PSP webhook lands. The Usage page reflects the new Recharge bucket.
Payment methodTop-Up Credits supportedNotes
StripeYes (primary)Card payments, full checkout flow.
PaddleSee in-appSubscription is the primary use of Paddle.
Apple IAPiOS appManaged via in-app purchase.
Google IAPAndroid appManaged via in-app purchase.
MoonPayCrypto top-upConfirmation arrives by email; Credits credit after on-chain confirmation.
warning

The Top-Up Credits page currently routes primarily through Stripe Checkout. Other PSP rails (Paddle / Apple IAP / Google IAP / MoonPay) for ad-hoc top-up are rolling out — the page shows only PSPs available for your region and platform.


3. Pricing

The minimum top-up is $10 and the maximum is $10,000 per transaction. Per-credit price falls as the amount grows — higher tiers get a built-in discount versus lower tiers.

Amount rangeEffective tierDiscount vs. base tier
$10 – $299Tier 1Base rate
$300+Tier 2Up to 20% better per-credit rate

The page shows two live numbers as you type:

  • You will receive — total Credits at the current amount.
  • Save N% badge — how much better per-credit you're getting versus Tier 1.
  • Next tier upsell — a "+$X to unlock Y extra credits" hint when you're close to the next break-point.
warning

Exact per-credit rates per tier are subject to change. The live quote on /top-up-credits is authoritative.


4. Receipt and ledger entry

Every successful Custom Credits purchase produces two artefacts:

  • A receipt in /account/billing alongside subscription invoices. Each row exposes a Download PDF action.
  • A ledger entry in /account/usage showing the credit (Recharge bucket increase) with timestamp, amount, and source = custom_credits.

Refer to /account/subscription-and-billing section 6 for invoice details, and /account/usage for the ledger view.


5. Refunds

Custom Credits are generally non-refundable once Credits are spent, since usage is metered in real time and individual credit-by-credit reversal isn't supported.

Where reversal is possible:

  • If the purchase was made within 24 hours and no Credits have been spent from the resulting Recharge bucket, Alphio Support can reverse the ledger entry and refund through the original PSP.
  • If any portion was spent, refund eligibility falls back to the standard Refund Policy at /support/refund-policy.

To request a reversal, contact /support/contact-us with your order ID (visible on /account/billing).

warning

Refund / reversal policy is being finalized. The 24-hour unspent-bucket reversal window is the current operational guideline but not yet a published contract — confirm with Support before relying on it.


Agent Instructions: Querying This Documentation

If you need information not on this page, you can query the docs dynamically by sending a GET request with the ask query parameter:

GET https://docs.alphio.ai/account/custom-credits.md?ask=<question>

The question should be specific, self-contained, and written in natural language. The response includes a direct answer plus relevant excerpts and sources.