Phase 7: Credit System
Timeline: Weeks 22-24 Status: Planned
Core Goal
Implement credit-based monetization system for request processing and voice services.
Credit System Overview
Token Pricing Structure
| Duration | Tokens | Human Voice | AI Voice |
|---|---|---|---|
| 0-30 sec | 1 token | 1 token | 0.5 tokens |
| 31-60 sec | 2 tokens | 2 tokens | 1 token |
| 61-180 sec | 3 tokens | 3 tokens | 1.5 tokens |
**Credit Packages (Sugesstion only) **
| Package | Credits | Price | Bonus | Best For |
|---|---|---|---|---|
| Starter | 10 | $10 | - | Testing |
| Basic | 50 | $45 | 5 free | Small projects |
| Pro | 200 | $160 | 40 free | Regular users |
| Enterprise | 1000 | $700 | 300 free | Large organizations |
Dynamic vs Static QR
Dynamic QR codes may have additional pricing differentiation in future phases.
Pilot Program: Token Bank Model
Voice Actor Token Donation
Pilot Requirements: Voice actors donate 60 tokens ($3,000 value) to the MicDots Token Bank.
| Duration | Products/Package | GVAA Rate | Tokens Required | Audio Files | Human Voice Tokens |
|---|---|---|---|---|---|
| :15 sec | 4 (package) | $100/each | 2 tokens | 4 | 4/set of 4 |
| :30 sec | 12 products | $150/each | 3 tokens | 10 | 15/product |
| :60 sec | 4 products | $250/each | 5 tokens | 3 | 7/product |
| :90 sec | 1 product | $300/each | 6 tokens | 1 | 3/product |
Token Value: Each token = $50
Pilot Client Allocation: Each pilot client receives 30 tokens to experiment with different voices and durations.
Token Classification System
Voice actors assign intent to donated tokens via Token Classification Form:
Categories:
- Client Discovery Tokens – Attract and onboard new clients
- Platform Growth Tokens – Promote MicDots awareness
- Nonprofit Donation Tokens – Fund mission-driven voiceovers
- Theme/Genre Tokens – Specific categories (Animation, Health, Faith, etc.)
- Education/Training Tokens – Workshops, demos, peer learning
- Collaboration/Mentorship Tokens – Support fellow actors
Example: "John Ferdinand: 60 Tokens → 20 Client Discovery, 20 Nonprofit, 20 Platform Growth"
Nonprofit Gift Package Model
Voice actors donate tokens directly to nonprofits:
Flow:
- Voice actor donates 10 tokens to specific nonprofit
- Nonprofit receives MicDots QR Gift Package
- Nonprofit redeems tokens for voiceover deliverables
- Transaction tracked on MicDots Token Ledger
- Voice actor earns "Impact Voice" badge + bonus tokens
Performance Metrics & Bonuses
| Metric | Description | Potential Reward |
|---|---|---|
| Token Velocity | Speed of token usage | Visibility boost, promotional feature |
| Client Retention Tokens | Repeat client usage | Bonus tokens, "Preferred Voice" status |
| Impact Tokens | Nonprofit/social cause usage | "Impact Contributor" badge, matching tokens |
| Collaboration Tokens | Multi-actor projects | Shared visibility, teamwork bonus |
| Training Tokens | Workshops, AI comparisons | Skill-building credits, professional dev |
Pilot Constraints
Pilot Restrictions
- ❌ Limited usage (no TV/Radio broadcasting)
- ⏰ 12-month expiration from MicDot posting date
- 📊 Access data tracked for 12 months
- 🎯 Nonprofit organizations preferred for pilot clients
Future Monetization
Planned Features:
- E-gift token packages
- Volunteer application system
- Token multipliers (1 bonus token per 10 donated/redeemed)
- External gift card integration
- Ambassador/marketing gift cards for voice actors
Standard Credit System Flows
Client Credit Purchase Flow
Business Rules:
- Payment must complete within 10 minutes
- Credits applied within 5 minutes of successful payment
- Receipt generated immediately
- Confirmation email sent within 10 minutes
- Failed payments allow 3 retry attempts
- Saved payment methods require re-authentication
Credit-Based Request Submission Flow
Business Rules:
- Cost calculator updates in real-time
- Balance checked before submission
- AI voice = 50% discount on all durations
- Tokens deducted only after confirmation
- Failed submissions refund tokens automatically
- Usage history updated immediately
Credit Expiration & Management Flow
Business Rules:
- Credits expire 12 months from purchase date
- Warning notifications: 30 days, 7 days, 1 day before expiration
- Expired credits cannot be used
- Refund requests must be within 90 days of purchase
- Unused credits eligible for prorated refund
- Partially used packages: refund calculation based on remaining balance
Admin Credit Management Flow
Business Rules:
Manual Adjustments:
- All adjustments require documented reason
- Subtractions require supervisor approval
- Client notified within 1 hour of adjustment
- All adjustments logged in audit trail
Refund Processing:
- Unused credits: full refund
- Partial use: prorated refund
- Processing time: 5-7 business days
- Refunds return to original payment method
- Quality issues: immediate credit restoration
Expiration Extensions:
- Extensions require justification
- Maximum extension: 90 days
- Client notified immediately
- Extension logged in system
Bonus Allocations:
- Can be conditional or unconditional
- Can target specific client segments
- Bonus credits may have different expiration
- Tracked separately in analytics
Acceptance Criteria
F6.1 - Credit Management
User Story: As client, I want to purchase and manage credits.
Acceptance Criteria:
- AC6.1.1: Given I'm logged in, when I access billing, then see current balance, usage history, purchase options
- AC6.1.2: Given I buy credits, when I view options, then see packages with clear pricing
- AC6.1.3: Given I select package, when I proceed, then see total including taxes based on location
- AC6.1.4: Given payment successful, when transaction completes, then credits added within 5 minutes and confirmation email sent
- AC6.1.5: Given insufficient credits, when I submit request, then see clear message about cost and purchase option
- AC6.1.6: Given I track usage, when I view history, then see: date, description, credits used, remaining balance
- AC6.1.7: Given unused credits, when I want refund, then see clear refund policy and request process
- AC6.1.8: Given frequent use, when I purchase, then can set auto-refill when balance drops below threshold
F6.2 - Payment Processing
User Story: As client, I want secure payment options.
Acceptance Criteria:
- AC6.2.1: Given I pay, when I access checkout, then see options: Credit Card (Stripe), PayPal, cryptocurrency
- AC6.2.2: Given I enter payment, when I submit, then SSL encrypted and PCI compliant processing
- AC6.2.3: Given payment fails, when error occurs, then specific error message with retry option
- AC6.2.4: Given payment processing, when I wait, then clear progress indicator and estimated completion
- AC6.2.5: Given I want receipt, when purchase completes, then detailed receipt via email within 10 minutes
- AC6.2.6: Given I need invoice, when I access billing history, then can generate and download invoices
- AC6.2.7: Given payment dispute, when I contact support, then access complete transaction history with reference numbers
- AC6.2.8: Given I save payment, when I check "save for future", then securely stored for convenient re-use
F6.3 - Admin Credit Management
User Story: As admin, I want to manage client credits.
Acceptance Criteria:
- AC6.3.1: Given I'm admin, when I access credit management, then see all clients with balances, transactions, payment status
- AC6.3.2: Given billing issue, when I investigate, then view complete credit history, payment attempts, usage patterns
- AC6.3.3: Given I adjust credits, when I access account, then can manually add/subtract with reason and approval workflow
- AC6.3.4: Given I make adjustment, when I save, then client receives email explaining change and new balance
- AC6.3.5: Given I offer promotion, when I apply discount, then can create credit bonuses for conditions or time periods
- AC6.3.6: Given payment fails repeatedly, when I review account, then see failed attempts and can contact client
- AC6.3.7: Given I need reports, when I access admin reports, then can generate revenue, credit usage, payment success rates
- AC6.3.8: Given suspected fraud, when I investigate, then can flag accounts and suspend credit usage
F6.4 - Dynamic Pricing
User Story: As system, I want to calculate appropriate credit costs.
Acceptance Criteria:
- AC6.4.1: Given client enters details, when they view submission, then see estimated credit cost before submitting
- AC6.4.2: Given text length varies, when cost calculated, then longer messages (over 500 chars) may cost additional credits
- AC6.4.3: Given voice selection, when client chooses premium, then additional cost clearly displayed in breakdown
- AC6.4.4: Given rush delivery, when client requests expedited, then rush fee added to total transparently
- AC6.4.5: Given multiple revisions, when client requests edits, then edit costs calculated by complexity
- AC6.4.6: Given promotional periods, when special pricing active, then discounts automatically applied and shown
- AC6.4.7: Given bulk requests, when client submits multiple, then volume discounts may automatically apply
- AC6.4.8: Given pricing changes, when rates updated, then existing pending requests honor original quoted price
F6.5 - Pilot Program: Voice Actor Token Donation
User Story: As voice actor, I want to donate tokens to MicDots Token Bank for pilot program.
Acceptance Criteria:
- AC6.5.1: Given I'm voice actor, when I access pilot enrollment, then see donation requirements: 60 tokens ($3,000 value)
- AC6.5.2: Given I donate tokens, when I complete Token Classification Form, then assign tokens to categories: Client Discovery, Platform Growth, Nonprofit, Theme/Genre, Education, Collaboration
- AC6.5.3: Given I submit donation, when accepted, then see confirmation showing: total tokens (60), category breakdown, deliverable requirements per duration (:15, :30, :60, :90 seconds)
- AC6.5.4: Given I donate deliverables, when uploaded, then system validates: audio quality, duration accuracy, format compliance
- AC6.5.5: Given my tokens used by clients, when transaction occurs, then see token velocity metrics, usage breakdown by duration, client feedback
- AC6.5.6: Given I participate in pilot, when I access dashboard, then see performance metrics: Token Velocity, Client Retention Tokens, Impact Tokens, Collaboration Tokens, Training Tokens
- AC6.5.7: Given I earn rewards, when metrics qualify, then receive: visibility boost, "Preferred Voice" status, "Impact Contributor" badge, bonus tokens
F6.6 - Pilot Program: Nonprofit Gift Packages
User Story: As voice actor, I want to donate token packages to nonprofits.
Acceptance Criteria:
- AC6.6.1: Given I donate to nonprofit, when I select organization, then specify: nonprofit name, token amount (minimum 10), purpose/message
- AC6.6.2: Given I confirm donation, when processed, then nonprofit receives: MicDots QR Gift Package, redemption instructions, expiration date (12 months)
- AC6.6.3: Given nonprofit redeems tokens, when they use platform, then transaction tracked on MicDots Token Ledger showing: donor name, recipient nonprofit, token amount, deliverables created
- AC6.6.4: Given my donation redeemed, when nonprofit completes order, then I receive: notification of usage, "Impact Voice" badge, bonus token reward, testimonial request
- AC6.6.5: Given I track donations, when I access gift history, then see: all donations sent, redemption status, nonprofit feedback, impact metrics
F6.7 - Pilot Program: Client Token Usage
User Story: As pilot client, I want to use allocated tokens to test MicDots platform.
Acceptance Criteria:
- AC6.7.1: Given I'm pilot client, when I access platform, then receive 30 tokens for experimentation
- AC6.7.2: Given I create request, when I select duration, then see token cost: :15 sec = 2 tokens, :30 sec = 3 tokens, :60 sec = 5 tokens, :90 sec = 6 tokens
- AC6.7.3: Given I select voice actor, when I browse, then see available donated deliverables, token classification (which categories actor assigned), sample audio
- AC6.7.4: Given I submit request, when I confirm, then tokens deducted from balance, request sent to matching voice actor pool
- AC6.7.5: Given I use tokens, when balance decreases, then see real-time balance, usage history, remaining capacity for different durations
- AC6.7.6: Given I want more tokens, when pilot balance depleted, then see options: request extension, purchase additional credits (transition to paid model), provide feedback
- AC6.7.7: Given pilot restrictions, when I receive deliverables, then see usage limits: no TV/Radio, 12-month expiration, access tracking notice
F6.8 - Pilot Program: Admin Token Management
User Story: As admin, I want to manage pilot program token bank and performance metrics.
Acceptance Criteria:
- AC6.8.1: Given I'm admin, when I access pilot dashboard, then see: total tokens donated, total voice actors enrolled, total pilot clients, token usage rate
- AC6.8.2: Given I review voice actors, when I access participant list, then see: name, tokens donated, token classification breakdown, deliverables uploaded, usage statistics
- AC6.8.3: Given I monitor usage, when I view Token Ledger, then see all transactions: donor, recipient, token amount, date, deliverable type, status
- AC6.8.4: Given I award bonuses, when I review performance metrics, then can manually or automatically assign: visibility boosts, "Preferred Voice" status, "Impact Contributor" badges, bonus tokens
- AC6.8.5: Given I manage nonprofits, when I review gift packages, then see: all nonprofit recipients, token amounts received, redemption status, feedback/testimonials
- AC6.8.6: Given pilot restrictions, when I audit deliverables, then verify: no TV/Radio usage, expiration dates enforced, access data tracked for 12 months
- AC6.8.7: Given pilot completion, when I analyze results, then generate reports: token velocity by voice actor, client retention rates, nonprofit impact, feature adoption rates
Pilot Program Flows
Voice Actor Enrollment Flow
Business Rules:
- Total tokens must equal exactly 60
- Minimum 10 tokens per category selected
- Audio files must match GVAA quality standards
- Each duration tier has specific file count requirements
- Files validated for: format (MP3/WAV), duration accuracy, audio quality
Nonprofit Gift Package Flow
Business Rules:
- Minimum gift package: 10 tokens
- Voice actor must have sufficient donated tokens
- Nonprofit receives email within 10 minutes
- Gift package expires after 12 months
- Redemption triggers donor notification
- Impact metrics updated in real-time
Pilot Client Usage Flow
Business Rules:
- Initial allocation: exactly 30 tokens per pilot client
- Token costs based on duration: :15=2, :30=3, :60=5, :90=6
- Real-time balance updates after each request
- Extension requests require admin approval
- Usage restrictions enforced: no TV/Radio
- 12-month expiration from request creation
- Access data tracked for analytics
Performance Metrics Calculation Flow
Metric Calculation Rules:
Token Velocity:
- Measures: tokens used per week
- Score = (tokens used / days since donation) × 7
- Threshold: 80% score = visibility boost
- Recalculated daily
Client Retention:
- Measures: repeat client usage rate
- Score = (repeat clients / total clients) × 100
- Threshold: 70% = Preferred Voice status
- Updated per transaction
Impact Tokens:
- Measures: nonprofit usage percentage
- Score = (nonprofit tokens / total tokens) × 100
- Threshold: 25% = Impact Contributor badge
- Includes gift packages and direct nonprofit orders
Collaboration Tokens:
- Measures: multi-actor project participation
- Count: number of ensemble/collaboration projects
- Threshold: 2+ projects = Teamwork Bonus
- Manually tracked by admin
Training Tokens:
- Measures: workshop/demo participation
- Count: tokens used in training contexts
- Threshold: 5+ uses = Skill Credits
- Admin-flagged transactions
Token Ledger Transaction Flow
Ledger Requirements:
- All transactions permanently recorded
- Immutable audit trail
- Real-time updates to dashboards
- Filterable by: voice actor, nonprofit, date range, transaction type
- Exportable for reporting
- Privacy controls for sensitive data
Business Rules & Conditions
Token Allocation Rules
Voice Actor Donations:
- ✅ Must donate exactly 60 tokens ($3,000 value)
- ✅ Token classification required at donation
- ✅ Can modify classification within 7 days of enrollment
- ✅ Can add additional donations beyond initial 60
- ❌ Cannot withdraw donated tokens
- ❌ Cannot change classification after deliverables used
Pilot Client Allocation:
- ✅ Each pilot client receives 30 tokens
- ✅ Tokens allocated at account approval
- ✅ Can request one extension (up to 30 additional tokens)
- ❌ Cannot purchase tokens during pilot phase
- ❌ Cannot transfer tokens to other clients
- ❌ Tokens expire after 12 months from allocation
Nonprofit Gift Packages:
- ✅ Minimum 10 tokens per gift package
- ✅ Voice actor can create multiple gift packages
- ✅ Nonprofit can receive from multiple donors
- ✅ Gift packages expire 12 months from issuance
- ❌ Tokens cannot be combined across packages
- ❌ Non-transferable to other nonprofits
Usage Restrictions
Deliverable Usage Limits:
- ✅ Web usage permitted
- ✅ Social media permitted
- ✅ Internal communications permitted
- ✅ Point-of-sale/retail permitted
- ❌ Television broadcasting prohibited
- ❌ Radio broadcasting prohibited
- ❌ Resale of audio prohibited
- ❌ Modification without permission prohibited
Duration & Expiration:
- 12 months from MicDot creation date
- Access data tracked for full 12 months
- Automatic expiration enforcement
- No extensions for pilot phase
- Renewals handled case-by-case by admin
Performance Reward Conditions
Automatic Rewards:
- Awarded when metric thresholds met
- Updated within 24 hours of qualifying transaction
- Visible on voice actor dashboard
- Included in monthly performance report
Manual Rewards (Admin Approval Required):
- Bonus token allocations
- Custom badge creation
- Featured voice placement
- Premium visibility packages
Reward Withdrawal Conditions:
- Fraud detected: immediate removal
- Terms violation: 7-day warning then removal
- Inactivity > 90 days: visibility rewards suspended
- Consistent low ratings: review and possible adjustment
Complete Pilot Program Lifecycle
Lifecycle Milestones:
Week 1-2: Enrollment
- Voice actors recruited and onboarded
- Deliverables uploaded and validated
- Token classifications assigned
- Voice profiles published
Week 3-4: Launch
- Pilot clients allocated 30 tokens each
- MicDots Token Bank goes live
- First client requests submitted
- Token ledger tracking begins
Week 5-24: Active Pilot
- Continuous client usage
- Performance metrics tracking
- Reward distribution
- Nonprofit gift packages active
- Monthly progress reports
Week 24: Completion & Analysis
- Final data collection
- Performance reviews
- Impact assessments
- Transition planning
Post-Pilot Options:
- Migrate to paid standard credits
- Extend pilot participation
- Archive pilot account
- Request additional tokens (admin approval)
Success Criteria
Standard Credit System
Client Experience:
- ✅ Clients can view and purchase credit packages within 3 clicks
- ✅ Credit balance visible on every page header
- ✅ Real-time cost preview before submitting requests
- ✅ Payment confirmation received within 10 minutes
- ✅ Credits applied to account within 5 minutes of payment
- ✅ Usage history accessible with filters (date, amount, status)
- ✅ Expiration warnings sent at 30, 7, and 1 day before expiration
- ✅ Refund requests processed within 7 business days
Admin Experience:
- ✅ Complete credit history visible for all clients
- ✅ Manual adjustments require reason and supervisor approval
- ✅ Refund policy automatically enforced
- ✅ Revenue reports generated on-demand
- ✅ Credit usage analytics updated in real-time
- ✅ Promotional bonus campaigns can be created and tracked
Pilot Program
Voice Actor Experience:
- ✅ Enrollment process completable within 30 minutes
- ✅ Token classification form intuitive and clear
- ✅ Deliverable upload with quality validation feedback
- ✅ Performance dashboard showing all 5 metrics
- ✅ Rewards automatically awarded within 24 hours
- ✅ Gift package creation in under 5 minutes
- ✅ Real-time notifications for token usage and rewards
Pilot Client Experience:
- ✅ 30 tokens allocated immediately upon approval
- ✅ Voice browsing filtered by token classification
- ✅ Token cost clearly displayed before submission
- ✅ Balance updated in real-time after each request
- ✅ Extension request process simple and clear
- ✅ Usage restrictions clearly communicated
Nonprofit Experience:
- ✅ Gift package email received within 10 minutes
- ✅ Redemption process requires no registration initially
- ✅ Token balance visible throughout platform usage
- ✅ Thank you message automatically sent to donor
- ✅ Clear usage restrictions displayed
Admin Experience:
- ✅ Token ledger shows all transactions with full details
- ✅ Performance metrics calculated automatically
- ✅ Reward distribution trackable and auditable
- ✅ Pilot completion reports generated with 1 click
- ✅ Voice actor and client analytics dashboard updated real-time
Business Outcomes
Pilot Program Goals:
- ✅ 20+ voice actors enrolled in pilot
- ✅ 10+ pilot clients actively using tokens
- ✅ 5+ nonprofit gift packages redeemed
- ✅ 75%+ token utilization rate
- ✅ 80%+ voice actor satisfaction with platform
- ✅ 70%+ pilot clients transition to paid
Platform Readiness:
- ✅ Token bank sustains 6-month pilot duration
- ✅ Performance metrics accurately reflect engagement
- ✅ Gift package flow validated by nonprofits
- ✅ Data collected informs pricing model for Phase 9
Deliverables
-
Payment System
- Stripe integration
- PayPal alternative
- Checkout flow
- Receipt generation
-
Credit Management
- Balance tracking
- Usage deduction
- Expiration handling
- Purchase history
-
Admin Tools
- Revenue dashboard
- Credit operations
- Refund processing
- Analytics
-
Pilot Program System
- Voice actor enrollment & donation tracking
- Token Classification Form
- Token Bank management
- Nonprofit gift package creation
- QR code gift package generation
- Token Ledger (transaction tracking)
- Performance metrics dashboard
- Pilot client allocation (30 tokens)
- Badge & reward system
-
User Documentation
- Client pricing guide
- Credit purchase walkthrough
- Refund policy document
- Voice actor pilot enrollment guide
- Token classification guidelines
- Nonprofit gift package instructions
- Performance metrics explanation
- Admin operations manual
Limitations (Phase 7)
Phase 7 Constraints
Standard Credit System:
- ❌ No payment processing (comes in Phase 9)
- ❌ Manual credit adjustments by admin only
- ❌ No automatic billing/invoicing
- ❌ Basic credit tracking only
Pilot Program:
- ✅ Token donation & tracking INCLUDED
- ✅ Nonprofit gift packages INCLUDED
- ✅ Performance metrics INCLUDED
- ✅ Token ledger INCLUDED
- ❌ E-gift card external sales (future phase)
- ❌ Ambassador marketing integration (future phase)
- ❌ Automated token multipliers (manual only)
Next Phase
➡️ Phase 8: AI Voice Generation