Skip to main content

Billing Voucher System

Feature Snapshot​

FieldValue
Feature nameVoucher Redemption System
Primary goalAllow users to redeem promotional codes for account credits
AvailabilityWorkspace owners and billing managers only
LocationPlans & Billing page → Redeem Voucher button

Key Facts the Model Must Know​

  • Vouchers add credits to workspace accounts, not individual users
  • Only workspace owners can redeem vouchers
  • Voucher codes are case-sensitive and single-use only
  • Credits are applied automatically when using Mito features
  • Invalid codes show "Invalid voucher code" error message
  • Successful redemption triggers confetti celebration and toast notification

Voucher Mechanics​

Redemption Flow​

  1. User clicks Redeem Voucher button in billing page header
  2. Dialog opens with input field for voucher code
  3. User enters code and clicks Redeem
  4. System validates code and adds credits if valid
  5. Success state shows celebration animation
  6. Dialog auto-closes after 6 seconds
  7. Credits balance updates immediately

Code Validation​

  • Codes are trimmed of whitespace automatically
  • Empty codes show "Please enter a voucher code"
  • Invalid/expired codes show "Invalid voucher code"
  • Server errors are sanitized to "Invalid voucher code"

Success Indicators​

  • Green checkmark icon appears
  • "Voucher Redeemed!" message displays
  • "Your credits have been added" confirmation
  • Confetti animation plays across screen
  • Toast notification: "Voucher redeemed! Your credits have been added to your account."

Supported Scenarios​

  • Help users redeem promotional voucher codes
  • Troubleshoot voucher redemption errors
  • Explain where redeemed credits appear
  • Guide users to the correct billing page location

Example Conversations​

Successful redemption guidance​

User: I have a voucher code. How do I redeem it?
Assistant: Go to Plans & Billing in your workspace, then click the "Redeem Voucher" button in the top right. Enter your voucher code and click Redeem. If it's valid, you'll see a celebration and your credits will be added immediately.

Troubleshooting invalid code​

User: My voucher says "Invalid voucher code" but I'm sure it's right.
Assistant: Double-check the code - they're case-sensitive. Make sure there are no extra spaces. The code might be expired or already used. If you're certain it should work, contact support with the voucher details.

Permission issue​

User: I can't find the Redeem Voucher button.
Assistant: Only workspace owners can redeem vouchers. If you're not the owner, ask them to redeem the code or give you billing permissions in the workspace settings.

Common Issues​

ProblemCauseSolution
"Invalid voucher code"Code expired, used, or typed wrongVerify code exactly, check expiration
Button not visibleNot workspace ownerAsk owner to redeem or grant permissions
Credits not appearingSystem delayRefresh page, wait a few minutes
Dialog won't openPermission restrictionsMust be workspace owner or billing manager

Error Messages the Model Should Recognize​

  • "Please enter a voucher code" → User submitted empty field
  • "Invalid voucher code" → Code validation failed
  • "Redeeming..." → Processing state, wait for result

Integration Points​

  • Credits system: Redeemed credits add to workspace balance
  • Analytics tracking: "voucher_redeemed" event fires on success
  • Query invalidation: Credits query refreshes to show new balance
  • Toast notifications: Success message appears in bottom corner
  • User guide: docs/user/account/redeem-voucher.md
  • Billing overview: Plans & Billing page documentation

Update Log​

  • 2026-01-22 — Initial documentation for voucher redemption feature