When you open the voidX AI app in your Shopify admin, the "Plan & usage" card sits under the "Home" tab. It is where you see your subscription status, token usage for the current 30-day cycle and your token pack balance, and where you start choosing or changing a plan and buying token packs.
Shopify handles payment and billing. The plan list and prices are on Shopify's plan selection page and the charges are on your Shopify bill; this card shows the state that results from them.
Screen layout
| Area | What it shows |
|---|---|
| Badge (top right of the card) | One of "No plan", "Light", "Premium" or "Paused" |
| Status notice | A notice that appears only when action is needed |
| Usage this 30-day cycle | A used tokens / included tokens gauge, "{n} tokens left" and "Resets on {date}" |
| Token pack balance | Your token pack balance and "Add {token count} tokens · $price" buttons |
| Choose a plan / Change plan | A button that opens Shopify's plan selection page, with "As of {time}" next to it |
"As of {time}" is when the status was checked. The card refreshes when you open the app home, and checks again when you come back from another tab or window. If the screen stays the same after you update your payment details in Shopify, refresh the app home.
Notices by status
| Badge | Notice | Status |
|---|---|---|
| No plan | "Choose a plan to let your AI assistant chat with visitors" | No subscription, no token pack. Chat blocked |
| No plan | "You're running on token pack credit without a subscription" | No subscription, chatting on token pack tokens |
| Light / Premium | No notice | Normal |
| Light / Premium | "You've used this cycle's tokens" | This cycle's tokens used up |
| Light / Premium | "Your subscription is scheduled to end on {date}" | App removed and reinstalled. Ends at the end of the cycle |
| Paused | "Your subscription is paused due to a billing issue" | Charges stopped due to a payment problem on your Shopify bill |
When "You've used this cycle's tokens" is shown, chat continues on token pack tokens if you have any, and stops if you don't. The date in the notice is the start of the next cycle.
"Paused" does not mean the subscription has ended; it means Shopify has stopped charging. Updating the payment details on your Shopify bill brings you back to the same cycle, and in the meantime only token pack tokens are used.
Order in which tokens are used
Subscription tokens are used first, and token pack tokens are used once this cycle's tokens run out. If neither is left, opening the chat shows visitors "AI chat is unavailable right now. Sorry for the inconvenience." and the chat does not open. If tokens run out in the middle of a reply, "The reply stopped here. Sorry for the inconvenience." is added.
| Type | When credited | Order of use | Expiry |
|---|---|---|---|
| Subscription tokens | Start of each 30-day cycle | Used first | Reset and re-credited at the start of each cycle. No carryover |
| Token pack tokens | When a token pack purchase is approved | Used after subscription tokens run out | No expiry |
Token pack tokens left over after your subscription ends remain and are still used for chat.
Choosing and changing plans
- Click "Choose a plan" or "Change plan". Shopify's plan selection page opens.
- Pick a plan and approve it.
- When you return to the app home, the badge changes to the new plan after the notice "Confirming your plan change. This can take up to about 10 seconds."
Plan changes, up or down, take effect immediately. This cycle's included tokens change to the new plan's amount, and tokens already used this cycle still count. Moving up increases your remaining tokens right away; moving down can show a full gauge if the amount already used exceeds the new allowance.
Changing plans starts a new 30-day cycle from the time you approve. Shopify settles the charge for the remaining period on your bill.
If you move from Premium to Light, the tone and rules saved in "Assistant settings" are not deleted; they simply stop being applied. Moving back to Premium restores them as they were.
Buying token packs
You can buy token packs only while subscribed to a plan. Before you subscribe, the buttons are disabled and "Token packs can be purchased while you have an active plan." is shown.
- Under "Token pack balance", click an "Add {token count} tokens · $price" button. There are two packs: 1,000,000 tokens and 2,500,000 tokens.
- When the Shopify approval page opens, approve the charge. Every token pack purchase goes through this approval.
- When you return to the app home, your balance increases along with the notice "Your token pack has been added."
If "We haven't confirmed the result of your purchase yet. Tokens are added automatically once it's approved." is shown, Shopify is still processing the payment, or you left the approval page without deciding. If you approved the charge, the tokens are added automatically shortly; if you didn't, nothing is added. Clicking the same pack again may charge you twice, so check whether your balance changes first. "The purchase wasn't approved, so no tokens were added." means the charge was declined on the approval page.
In "Paused" status, "You can buy token packs again once the billing issue is resolved." is shown and purchases are blocked.
Canceling
Canceling a Shopify app subscription means removing the app. When you remove voidX AI under Shopify admin > Apps, the subscription stays active until the end of the current cycle and ends on that date. Charges for the remaining period are not refunded.
If you reinstall the app within the same cycle, it opens right away without an approval screen and shows "Your subscription is scheduled to end on {date}". To keep using it, click "Open plan page" and approve a plan again. Re-approving starts a new 30-day cycle from that time. If you reinstall after the end date, you start in "No plan" status, and any remaining token pack tokens can still be used.
Next steps
- For installation steps, see Shopify app.
- For how tokens are deducted, see Tokens and usage.
- For checks when chat is blocked, see Tokens used up.
- For conversations between visitors and the agent, see Conversation history (Shopify).