upfall
Skip to content
Documents

Plan and usage (Shopify)

Describes how to check your subscription status, this cycle's tokens and token packs on the "Plan & usage" card of the Shopify app home, and how to change or cancel your plan.

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

AreaWhat it shows
Badge (top right of the card)One of "No plan", "Light", "Premium" or "Paused"
Status noticeA notice that appears only when action is needed
Usage this 30-day cycleA used tokens / included tokens gauge, "{n} tokens left" and "Resets on {date}"
Token pack balanceYour token pack balance and "Add {token count} tokens · $price" buttons
Choose a plan / Change planA 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

BadgeNoticeStatus
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 / PremiumNo noticeNormal
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.

TypeWhen creditedOrder of useExpiry
Subscription tokensStart of each 30-day cycleUsed firstReset and re-credited at the start of each cycle. No carryover
Token pack tokensWhen a token pack purchase is approvedUsed after subscription tokens run outNo expiry

Token pack tokens left over after your subscription ends remain and are still used for chat.


Choosing and changing plans

  1. Click "Choose a plan" or "Change plan". Shopify's plan selection page opens.
  2. Pick a plan and approve it.
  3. 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.

  1. 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.
  2. When the Shopify approval page opens, approve the charge. Every token pack purchase goes through this approval.
  3. 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