Vitez

Subscriber guide

How to subscribe to a creator's plan, manage your subscription, and understand what happens when a payment succeeds or fails.

1. What you need

  • A wallet on Base (MetaMask, Coinbase Wallet, or any WalletConnect- compatible wallet).
  • USDC on Base — enough to cover the plan price plus the 2.5% protocol fee for the first period. You can bridge USDC from Ethereum mainnet or buy it directly on a centralised exchange that supports Base withdrawals.
  • A small amount of ETH on Base (a few cents) to pay gas for the subscription transaction.

2. Subscribing to a plan

  1. Open the plan's checkout link — it looks like vitez.app/p/<planId>. The creator shares this link in their community or bio.
  2. Click Connect wallet and approve the connection in your wallet app.
  3. Review the plan details: price, billing period, and the first-payment breakdown (plan price + 2.5% fee).
  4. Click Subscribe. Your wallet will first ask you to approve a USDC spending allowance (this is an ERC-20 approve transaction), then ask you to confirm the subscription transaction.
  5. Once the subscription transaction confirms, you will see a success screen. If the plan is gated to a Telegram group or Discord server, access is granted automatically within a few seconds.

3. Auto-renew

Auto-renew is on by default. When you subscribe, you approve a “max allowance” for the USDC contract, which lets the Vitez relayer pull the renewal amount automatically at the end of each billing period.

You can turn auto-renew off at any time from your /me dashboard by clicking Disable auto-renew next to the subscription. Your current paid period is not affected — you keep access until expiry.

You can re-enable auto-renew at any time while the subscription is still active.

4. What happens at renewal

The Vitez renewal cron runs every 15 minutes. Around the time your subscription expires (within 1 hour), it calls the contract to pull the next period's payment from your wallet:

  • Success — USDC is deducted, your expiry extends by one period, and you keep access without interruption.
  • Failure (insufficient balance or allowance) — Vitez emails you a payment failure notice and retries once. If the retry also fails, your subscription is auto-cancelled and access is revoked.

To avoid failed renewals, make sure your wallet holds enough USDC and that the spending allowance is still in place. Revoking the USDC allowance for the contract will prevent renewals.

5. Cancelling a subscription

Go to /me and click Cancel next to the subscription. Your wallet will sign a transaction to call registry.cancel(subId). This:

  • Turns off auto-renew immediately.
  • Does not refund the current period — you keep access until the expiry timestamp.
  • Revokes community access (Telegram / Discord) at expiry, not at cancellation.

6. How community access works

Once your subscription is active, Vitez grants access based on the community type:

  • Telegram — you receive a one-time invite link to the group. Use it once; the link expires after use. If you are kicked (on expiry) and re-subscribe later, you will receive a new invite link.
  • Discord — the Vitez bot grants a designated role in the server. When your subscription lapses, the role is revoked. If you are already in the server, you stay — only the role changes.

Access changes happen within seconds of a subscription event confirming on-chain. If you do not receive your invite link or role within a few minutes, email founders@vitez.app.

7. Your subscription dashboard

/me shows all subscriptions associated with your connected wallet, grouped into:

  • Active — paid and not yet expired.
  • Expired — lapsed without renewal or after cancellation.
  • Cancelled — explicitly cancelled; access active until expiry.

Each row shows a live “expires in X days” countdown, auto-renew toggle, and a payment history table pulled from the indexer.

8. Fees and refunds

Vitez charges a 2.5% protocol fee at each payment. The exact amount is always shown at checkout before you sign. Because payments are on-chain transactions, they are irreversible — Vitez cannot issue refunds. If you have a dispute with a creator, contact them directly.

Questions? founders@vitez.app. Also see the Creator guide.