Setting up auto-top-up
Auto-top-up watches your wallet balance and prepares a Shopify charge confirmation URL for you whenever the balance drops below a threshold you set. Shopify requires your explicit approval for every charge — Auto-top-up makes that approval one click instead of a multi-step manual flow.
Where to enable
Billing tab → Auto top-up section → toggle on.
Configuration
| Field | Default | What it does |
|---|---|---|
| Threshold | $5 | When balance drops below this, Auto-top-up prepares a charge URL. |
| Amount | $25 | How much the prepared charge will be for. |
How it works
- Wallet balance drops below threshold (e.g. $4.97 after a fix).
- RankEngine creates a Shopify
appPurchaseOneTimecharge for the configured amount and saves the confirmation URL. - Next time you open the app, a "Confirm $25 top-up" banner appears at the top of the AI Wallet section in Billing.
- Click "Confirm" → Shopify shows its standard charge approval page → approve.
- Wallet credited within seconds. Activity log shows
type=auto_topupin Transactions.
Why a click is needed: Shopify's Billing API does not allow apps to charge merchants without explicit per-charge approval. There is no "headless" auto-charge for Shopify apps — even your subscription renewals are managed by Shopify itself, not by us. Auto-top-up cuts the prep work to one click; we can't (and won't) charge you without that click.
Cooldown
If a prepared top-up sits unconfirmed for 24 hours, RankEngine doesn't create a second one — you'll see one pending charge banner at a time. Click confirm or re-enable the toggle once you're ready, and the next cycle will create a fresh charge if you're still below threshold.
Failed charges
If Shopify declines the charge after you confirm (rare; usually a billing issue on the merchant's side), the wallet stays at the pre-charge balance, the pending charge clears, and the banner reappears next cycle.
When to enable
✅ You run Autopilot rules continuously and don't want to lose fix throughput while waiting to remember to top up. ✅ You generate blog content on a schedule (Calendar → "Schedule batch") and want the charge URL ready when you next open the app. ✅ You'd rather click "Confirm $25" once than navigate the manual top-up flow every couple of weeks.
When to disable
❌ You want to evaluate cost before each charge — manual top-up gives the same per-charge approval but on your own timing. ❌ You're testing — see exactly what each task costs before committing to recurring spend.