FAQs and Limitations
Questions
Is GST charged when credits are spent? No. GST is charged on the top-up invoice only. A line fully paid from credits has no GST, and a partly covered line is taxed on the uncovered part.
Do paid credits expire? Never. Expiry applies to bonus credits and once-grants. Every-period grants follow the rollover setting.
Which credits are spent first? The ones that expire soonest. Credits that never expire are spent last.
Can a customer get a refund of unused credits? No. Wallet credits are not refundable and cannot be cashed out. On cancel they carry over to the account’s next subscription with a wallet price.
Can two subscriptions share a wallet? No. A wallet belongs to one subscription. Only that subscription’s charges draw from it.
What if the customer buys credits in another currency? The wallet takes the subscription’s currency. A top-up in another currency is rejected.
Does a base fee draw from credits? Only if you tick Paid from credits on it. The builder leaves it off for the base fee and seats, and on for usage, per-event and pass-through pieces.
Can I use credits on add-ons? No. Add-on prices have no wallet.
What happens after a refund or chargeback of a top-up? You call the reversal. Unspent credit is removed and the spent part is billed on the next invoice as Credits reversed.
Does an ordinary credit (from a cancellation or a downgrade) pay a top-up invoice? No. A top-up invoice can only be paid by a payment.
Limitations
- Balance checks run daily, after each drawdown and on request, not on every usage event. Usage between checks can take the balance below zero, and is billed as overage.
- The projected balance can understate the next draw on renewals that are not on the period boundary, so a block or an auto top-up can come up to one period late.
- The auto top-up pack is an index into the pack list. Removing a pack shifts it.
- Your own PDF templates do not print the credit rows. The standard template does.
- A plan change that replaces a renewal invoice the wallet paid can return the wallet-paid credit twice (once to the wallet, once as ordinary credit). Known issue.
- A returned drawdown can land on an entry that has since expired or been charged back.
- A large invoice discount on an invoice with an untaxed drawing line can over-draw. Rare.
- The chargeback reversal is manual: no gateway webhook calls it.
- Expiry after the expiry days and a second-period rollover were not checked on a real clock before release.
- A real gateway or mandate top-up payment was not checked live. It was paid offline.
- A coupon on a GST wallet invoice was only unit-tested.
- Not covered: refunds, cash-out, sharing across accounts, add-on wallets, percentage pricing and commitments.
- Rollback: once wallet entries exist, rolling back the facade alone is unsafe. Roll back with wallet prices disabled.